将单个搜索中的一个因素,并返回按照此顺序匹配的重载。
1.如果没有匹配项,则为 null。
2.当有一个匹配项时,无论该身份标识处于活动状态。
3.单个活动的标识匹配,该身份时。
命名空间: Microsoft.TeamFoundation.Framework.Server
程序集: Microsoft.TeamFoundation.Framework.Server(在 Microsoft.TeamFoundation.Framework.Server.dll 中)
语法
声明
Public Function ReadIdentity ( _
requestContext As TeamFoundationRequestContext, _
searchFactor As IdentitySearchFactor, _
factorValue As String, _
queryMembership As MembershipQuery, _
readOptions As ReadIdentityOptions, _
propertyNameFilters As IEnumerable(Of String), _
propertyScope As IdentityPropertyScope _
) As TeamFoundationIdentity
public TeamFoundationIdentity ReadIdentity(
TeamFoundationRequestContext requestContext,
IdentitySearchFactor searchFactor,
string factorValue,
MembershipQuery queryMembership,
ReadIdentityOptions readOptions,
IEnumerable<string> propertyNameFilters,
IdentityPropertyScope propertyScope
)
参数
- requestContext
类型:Microsoft.TeamFoundation.Framework.Server.TeamFoundationRequestContext
- searchFactor
类型:Microsoft.TeamFoundation.Framework.Common.IdentitySearchFactor
- factorValue
类型:System.String
- queryMembership
类型:Microsoft.TeamFoundation.Framework.Common.MembershipQuery
- propertyNameFilters
类型:System.Collections.Generic.IEnumerable<String>
仅在需要时读取选项包括扩展的属性、 属性服务 API,请参阅。可以为空否则。
- propertyScope
类型:Microsoft.TeamFoundation.Framework.Common.IdentityPropertyScope
返回值
类型:Microsoft.TeamFoundation.Framework.Server.TeamFoundationIdentity
返回 TeamFoundationIdentity。
实现
异常
异常 | 条件 |
---|---|
MultipleIdentitiesFoundException | 当有多个匹配项,除非正在使用一个标识引发。 |
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。