TeamFoundationIdentityService.ReadIdentity 方法 (TeamFoundationRequestContext, IdentitySearchFactor, String, MembershipQuery, ReadIdentityOptions, IEnumerable<String>)

多載會採用單一搜尋係數，並傳回此順序的符合項目。

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) _
) As TeamFoundationIdentity

public TeamFoundationIdentity ReadIdentity(
    TeamFoundationRequestContext requestContext,
    IdentitySearchFactor searchFactor,
    string factorValue,
    MembershipQuery queryMembership,
    ReadIdentityOptions readOptions,
    IEnumerable<string> propertyNameFilters
)

參數

• requestContext
  型別：Microsoft.TeamFoundation.Framework.Server.TeamFoundationRequestContext

• searchFactor
  型別：Microsoft.TeamFoundation.Framework.Common.IdentitySearchFactor

• factorValue
  型別：System.String

• queryMembership
  型別：Microsoft.TeamFoundation.Framework.Common.MembershipQuery

• readOptions
  型別：Microsoft.TeamFoundation.Framework.Common.ReadIdentityOptions

• propertyNameFilters
  型別：System.Collections.Generic.IEnumerable<String>
  僅時需要讀取選項包含擴充的屬性資訊，請參閱屬性服務 API。可為 null 否則。

傳回值

型別：Microsoft.TeamFoundation.Framework.Server.TeamFoundationIdentity
傳回 TeamFoundationIdentity。

實作

ITeamFoundationIdentityService.ReadIdentity(TeamFoundationRequestContext, IdentitySearchFactor, String, MembershipQuery, ReadIdentityOptions, IEnumerable<String>)

例外狀況

例外狀況	條件
MultipleIdentitiesFoundException	當擲回多個符合項目，除非正好與其中一個識別正在使用中。

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

TeamFoundationIdentityService 類別

ReadIdentity 多載

Microsoft.TeamFoundation.Framework.Server 命名空間