Partager via


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.String

    Le nom d'ouverture de session Active Directory de l'utilisateur.

  • allowBrowseUserInfo
    Type : System.Boolean

    true 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.Boolean

    true 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.

Voir aussi

Référence

SPWeb classe

SPWeb - Membres

Microsoft.SharePoint - Espace de noms