Utility.SearchPrincipals método
Retorna a coleção de objetos que parcialmente ou exclusivamente correspondem ao critério de pesquisa especificado.
Namespace: Microsoft.SharePoint.Client.Utilities
Assemblies: Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)
Sintaxe
'Declaração
Public Shared Function SearchPrincipals ( _
context As ClientRuntimeContext, _
web As Web, _
input As String, _
scopes As PrincipalType, _
sources As PrincipalSource, _
usersContainer As UserCollection, _
maxCount As Integer _
) As IList(Of PrincipalInfo)
'Uso
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 maxCount As Integer
Dim returnValue As IList(Of PrincipalInfo)
returnValue = Utility.SearchPrincipals(context, _
web, input, scopes, sources, usersContainer, _
maxCount)
public static IList<PrincipalInfo> SearchPrincipals(
ClientRuntimeContext context,
Web web,
string input,
PrincipalType scopes,
PrincipalSource sources,
UserCollection usersContainer,
int maxCount
)
Parâmetros
- context
Tipo: Microsoft.SharePoint.Client.ClientRuntimeContext
web
Tipo: Microsoft.SharePoint.Client.WebEspecifica o site para ser usado ao procurar por uma entidade de segurança.
Ele não deve ser NULL.
input
Tipo: System.StringEspecifica o valor a ser usada ao procurar por uma entidade de segurança.
Se isso não for o nome de exibição, endereço de email ou nome de login de um capital, o servidor deve retornar NULL.
Ele não deve ser NULL. Seu comprimento deve ser igual ou menor do que 255.
scopes
Tipo: Microsoft.SharePoint.Client.Utilities.PrincipalTypeEspecifica o tipo a ser usada ao procurar por uma entidade de segurança.
sources
Tipo: Microsoft.SharePoint.Client.Utilities.PrincipalSourceEspecifica a origem a ser usada ao procurar por uma entidade de segurança.
usersContainer
Tipo: Microsoft.SharePoint.Client.UserCollectionEspecifica o conjunto de usuários a ser usada ao procurar por uma entidade de segurança.
maxCount
Tipo: System.Int32Especifica o número máximo de objetos a ser retornado na lista.
Se o valor for igual ou menor do que 0, o servidor deve retornar uma coleção vazia.
Valor retornado
Tipo: System.Collections.Generic.IList<PrincipalInfo>
Retorna uma instância de IList<T> que representa a coleção de objetos que parcialmente ou exclusivamente correspondem ao critério de pesquisa especificado.
Exceções
Exceção | Condição |
---|---|
[System.UnauthorizedAccessException] | O usuário atual tem permissões suficientes. Código de erro: -2147024891. |