SPRoleCollection.Add - Méthode

Remarque : cette API est désormais obsolète.

Obsolète. Utilisez à la place, les nouvelles classes SPRoleDefinition et SPRoleAssignment pour définir des rôles et de leur affecter des utilisateurs. Pour plus d'informations, consultez Changes in the Authorization Object Model. (Dans Windows SharePoint Services 2.0, la méthode Add de créer un objet de rôle avec le masque de nom, la description et autorisation spécifié dans la collection et est conservée pour la compatibilité ascendante.)

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
<ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")> _
Public Sub Add ( _
    name As String, _
    description As String, _
    permissionMask As SPRights _
)
'Utilisation
Dim instance As SPRoleCollection
Dim name As String
Dim description As String
Dim permissionMask As SPRights

instance.Add(name, description, permissionMask)

[ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")]
public void Add(
    string name,
    string description,
    SPRights permissionMask
)

Paramètres

• name
  Type : System.String

  Chaîne qui contient le nom du rôle.

• description
  Type : System.String

  Chaîne qui contient la description du rôle.

• permissionMask
  Type : Microsoft.SharePoint.SPRights

  Une valeur dedeSPRightsqui spécifie les droits pour le masque d'autorisation.

Remarques

Pour définir un masque d'autorisation pour un utilisateur ou un groupe qui se compose de plusieurs droits, utilisez le symbole de canal ("|") dans Microsoft Visual C# ou Or dans Microsoft Visual Basic pour délimiter les droits.

Exemples

L'exemple de code suivant ajoute un rôle qui possède des autorisations pour gérer le site et ses sous-sites.

Dim site As SPWeb = 
    SPContext.Current.Site.AllWebs("Site_Name")
Dim roles As SPRoleCollection = site.Roles

roles.Add("Role_Name", "Description", SPRights.ManageWeb _ 
    Or SPRights.ManageSubwebs)

using(SPWeb oWebsite = SPContext.Current.Site.AllWebs["Site_Name"])
{
    SPRoleCollection collRoles = oWebsite.Roles;

    collRoles.Add("Role_Name", "Description", SPRights.ManageWeb | 
        SPRights.ManageSubwebs);
}

Voir aussi

Référence

SPRoleCollection classe

SPRoleCollection - Membres

Microsoft.SharePoint - Espace de noms