将关系图中某一缓冲区内的快照范围映射到谓词所选择的某一源快照中的零个或多个范围序列。
命名空间： Microsoft.VisualStudio.Text.Projection
程序集： Microsoft.VisualStudio.Text.Data（在 Microsoft.VisualStudio.Text.Data.dll 中）
语法
声明
Function MapDownToFirstMatch ( _
span As SnapshotSpan, _
trackingMode As SpanTrackingMode, _
match As Predicate(Of ITextSnapshot) _
) As NormalizedSnapshotSpanCollection
NormalizedSnapshotSpanCollection MapDownToFirstMatch(
SnapshotSpan span,
SpanTrackingMode trackingMode,
Predicate<ITextSnapshot> match
)
NormalizedSnapshotSpanCollection^ MapDownToFirstMatch(
SnapshotSpan span,
SpanTrackingMode trackingMode,
Predicate<ITextSnapshot^>^ match
)
abstract MapDownToFirstMatch :
span:SnapshotSpan *
trackingMode:SpanTrackingMode *
match:Predicate<ITextSnapshot> -> NormalizedSnapshotSpanCollection
function MapDownToFirstMatch(
span : SnapshotSpan,
trackingMode : SpanTrackingMode,
match : Predicate<ITextSnapshot>
) : NormalizedSnapshotSpanCollection
参数
span
类型：Microsoft.VisualStudio.Text.SnapshotSpan要映射的范围。
trackingMode
类型：Microsoft.VisualStudio.Text.SpanTrackingMode如何跟踪 span 直到当前快照（如果需要）。
match
类型：Predicate<ITextSnapshot>标识目标缓冲区的谓词。
返回值
类型：Microsoft.VisualStudio.Text.NormalizedSnapshotSpanCollection
topSpan 要映射到的目标缓冲区中的零个或多个快照范围的集合。
异常
| 异常 | 条件 |
|---|---|
| ArgumentNullException | span。快照或 match 是 nullnull 引用（在 Visual Basic 中为 Nothing）。 |
| ArgumentOutOfRangeException | trackingMode 不是有效的 SpanTrackingMode。 |
备注
match 对缓冲区关系图中的每个文本缓冲区，直到返回 true。 谓词将不再调用。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息，请参阅通过部分受信任的代码使用库。