Utility.ResolvePrincipal 方法
傳回符合特定的搜尋準則的主體的相關資訊。如果找不到相符的項目，伺服器必須傳回NULL。
命名空間: Microsoft.SharePoint.Client.Utilities
組件： Microsoft.SharePoint.Client.Silverlight (在 Microsoft.SharePoint.Client.Silverlight.dll 中); Microsoft.SharePoint.Client.Phone (在 Microsoft.SharePoint.Client.Phone.dll 中) Microsoft.SharePoint.Client (在 Microsoft.SharePoint.Client.dll 中)
語法
'宣告
Public Shared Function ResolvePrincipal ( _
context As ClientRuntimeContext, _
web As Web, _
input As String, _
scopes As PrincipalType, _
sources As PrincipalSource, _
usersContainer As UserCollection, _
inputIsEmailOnly As Boolean _
) As ClientResult(Of PrincipalInfo)
'用途
Dim context As ClientRuntimeContext
Dim web As Web
Dim input As String
Dim scopes As PrincipalType
Dim sources As PrincipalSource
Dim usersContainer As UserCollection
Dim inputIsEmailOnly As Boolean
Dim returnValue As ClientResult(Of PrincipalInfo)
returnValue = Utility.ResolvePrincipal(context, _
web, input, scopes, sources, usersContainer, _
inputIsEmailOnly)
public static ClientResult<PrincipalInfo> ResolvePrincipal(
ClientRuntimeContext context,
Web web,
string input,
PrincipalType scopes,
PrincipalSource sources,
UserCollection usersContainer,
bool inputIsEmailOnly
)
參數
web
類型：Microsoft.SharePoint.Client.Web指定搜尋的本金時所要使用的網站。
它必須NULL.
input
類型：System.String指定要搜尋的本金時使用的值。
如果這不是顯示名稱、 電子郵件地址或主要登入名稱，伺服器必須傳回NULL
其長度必須等於或小於 255。
scopes
類型：Microsoft.SharePoint.Client.Utilities.PrincipalType指定要搜尋的本金時使用的類型。
sources
類型：Microsoft.SharePoint.Client.Utilities.PrincipalSource指定要搜尋的本金時使用的來源。
usersContainer
類型：Microsoft.SharePoint.Client.UserCollection指定要搜尋的本金時使用的使用者的集合。
inputIsEmailOnly
類型：System.Boolean指定一個主體搜尋時，是否會使用電子郵件地址。
傳回值
類型：Microsoft.SharePoint.Client.ClientResult<PrincipalInfo>
傳回代表轉換日期和時間格式，取得資訊的使用者名稱，用於修改存取網站，以及管理部署中的其他工作的工具ClientResult<T>執行個體。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| [System.UnauthorizedAccessException] | 目前的使用者會有足夠的權限。錯誤碼 ︰-2147024891。 |