SPWeb.AddApplicationPrincipal - Méthode
Ajoute un utilisateur au site Web en tant qu'application principale ; Autrement dit, un objet utilisateur qui est délégué à agir au nom d'une application externe.
Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Function AddApplicationPrincipal ( _
logonName As String, _
allowBrowseUserInfo As Boolean, _
requireRequestToken As Boolean _
) As SPUser
'Utilisation
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
)
Paramètres
logonName
Type : System.StringLe nom d'ouverture de session Active Directory de l'utilisateur.
allowBrowseUserInfo
Type : System.Booleantrue pour permettre au nouvel utilisateur principal application accéder aux informations sur les utilisateurs de site Web ; dans le cas contraire, false.
requireRequestToken
Type : System.Booleantrue pour exiger que le nouvel utilisateur principal d'application possède un jeton de demande ; dans le cas contraire, false.
Valeur renvoyée
Type : Microsoft.SharePoint.SPUser
L'utilisateur principal de l'application.
Exceptions
| Exception | Condition |
|---|---|
| SPException | Il existe déjà un utilisateur sur le site Web avec le nom d'ouverture de session logonName qui n'est pas une application principale. |
| ArgumentOutOfRangeException | Aucun utilisateur portant le nom d'ouverture de session spécifié n'a été trouvé dans Active Directory. |
Remarques
Cette méthode peut uniquement s'exécuter dans le contexte de l'utilisateur d'un administrateur de collection de sites ou dans un appel à RunWithElevatedPrivileges(SPSecurity.CodeToRunElevated).
Lorsque cette méthode est appelée, l'utilisateur doit déjà exister dans Active Directory, mais ne doit pas exister en tant qu'utilisateur du site Web avec des autorisations, sauf s'ils sont déjà un principal d'application.