SPRoleCollection.Add-Methode

HINWEIS: Diese API ist veraltet.

Veraltet. Verwenden Sie stattdessen die neuen Klassen SPRoleDefinition und SPRoleAssignment , Definieren von Rollen und Benutzer zuweisen. Weitere Informationen finden Sie unter Changes in the Authorization Object Model. (In Windows SharePoint Services 2.0, die Add -Methode erstellt ein Objekt für die Rolle mit der angegebene Name, Beschreibung und Berechtigung in der Auflistung und wird für die Abwärtskompatibilität beibehalten.)

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
<ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")> _
Public Sub Add ( _
    name As String, _
    description As String, _
    permissionMask As SPRights _
)
'Usage
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
)

Parameter

• name
  Typ: System.String

  Eine Zeichenfolge, die den Namen der Rolle enthält.

• description
  Typ: System.String

  Eine Zeichenfolge, die Beschreibung der Rolle enthält.

• permissionMask
  Typ: Microsoft.SharePoint.SPRights

  EinSPRights-Wert, der für die Berechtigungsmaske Rechte angibt.

Hinweise

Verwenden Sie zum Definieren einer Berechtigungsmaske für einen Benutzer oder eine Gruppe, die mehrere Rechte besteht aus den senkrechten Strichs ("|") in Microsoft Visual C#- oder Or in Microsoft Visual Basic, um die Rechte zu begrenzen.

Beispiele

Das folgende Codebeispiel fügt eine Funktion, die über Berechtigungen zum Verwalten der Website und deren Unterwebsites verfügt.

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);
}

Siehe auch

Referenz

SPRoleCollection Klasse

SPRoleCollection-Member

Microsoft.SharePoint-Namespace