SPRoleCollection.Add-Methode

Artikel
05/06/2015

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

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, wenn sie nicht mehr benötigt werden. Informationen zu bewährten Codierung finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPRoleCollection Klasse

SPRoleCollection-Member

Microsoft.SharePoint-Namespace

Freigeben über