SPWeb.AddApplicationPrincipal method
Adiciona um usuário ao site como um aplicativo principal; Isto é, um objeto de usuário delegado ao agir em nome de um aplicativo externo.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
Public Function AddApplicationPrincipal ( _
logonName As String, _
allowBrowseUserInfo As Boolean, _
requireRequestToken As Boolean _
) As SPUser
'Uso
Dim instance As SPWeb
Dim logonName As String
Dim allowBrowseUserInfo As Boolean
Dim requireRequestToken As Boolean
Dim returnValue As SPUser
returnValue = instance.AddApplicationPrincipal(logonName, _
allowBrowseUserInfo, requireRequestToken)
public SPUser AddApplicationPrincipal(
string logonName,
bool allowBrowseUserInfo,
bool requireRequestToken
)
Parâmetros
logonName
Type: System.StringO nome de logon do Active Directory do usuário.
allowBrowseUserInfo
Type: System.Booleantrue para permitir que o novo usuário principal do aplicativo acessar informações sobre os usuários do site; Caso contrário, false.
requireRequestToken
Type: System.Booleantrue para exigir que o novo usuário principal do aplicativo tem um token de solicitação; Caso contrário, false.
Valor retornado
Type: Microsoft.SharePoint.SPUser
O usuário principal do aplicativo.
Exceptions
| Exception | Condition |
|---|---|
| SPException | Já existe um usuário no site com a do nome de logon logonName que não é um aplicativo principal. |
| ArgumentOutOfRangeException | Nenhum usuário com o nome de logon especificado foi encontrado no Active Directory. |
Comentários
Este método só pode ser executado no contexto do usuário de um administrador de conjunto de sites ou em uma chamada para RunWithElevatedPrivileges(SPSecurity.CodeToRunElevated).
Quando esse método é chamado, ele já deve existir no Active Directory, mas não deve existir como um usuário do site com as permissões, a menos que já seja um objeto de aplicativo.