SPRoleDefinitionCollection.Add-Methode

Eine neue Rollendefinition und der Auflistung hinzugefügt.

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

Syntax

'Declaration
Public Sub Add ( _
    role As SPRoleDefinition _
)
'Usage
Dim instance As SPRoleDefinitionCollection
Dim role As SPRoleDefinition

instance.Add(role)

public void Add(
    SPRoleDefinition role
)

Parameter

• role
  Typ: Microsoft.SharePoint.SPRoleDefinition

  Die Funktionsdefinition hinzugefügt werden.

Ausnahmen

Ausnahme	Bedingung
ArgumentException	Die Funktionsdefinition der aktuellen Website erbt nicht von der übergeordneten Website. -ODER- Die aktuelle Website muss nicht eindeutige Rollendefinition (die HasUniqueRoleDefinitions -Eigenschaft der aktuellen Website ist false).

Beispiele

Im folgenden Codebeispiel wird eine Rollendefinition erstellt, Eigenschaftenwerte festlegt und der Auflistung von Rollendefinitionen für eine Website die neue Rollendefinition hinzugefügt.

using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["Subsite_Name"])
{
    SPRoleDefinitionCollection collRoleDefinitions = oWebsite.RoleDefinitions;
    SPRoleDefinition oRoleDefinition = new SPRoleDefinition();
    oRoleDefinition.BasePermissions = SPBasePermissions.AddListItems |
    SPBasePermissions.BrowseDirectories | SPBasePermissions.EditListItems;
    oRoleDefinition.Description = "My custom definition.";
    oRoleDefinition.Name = "Custom Role Definition";
    collRoleDefinitions.Add(oRoleDefinition);
}

Using oWebsite As SPWeb = SPContext.Current.Site.AllWebs("Subsite_Name")
   Dim collRoleDefinitions As SPRoleDefinitionCollection = oWebsite.RoleDefinitions
   Dim oRoleDefinition As New SPRoleDefinition()
   oRoleDefinition.BasePermissions = SPBasePermissions.AddListItems Or SPBasePermissions.BrowseDirectories Or SPBasePermissions.EditListItems
   oRoleDefinition.Description = "My custom definition."
   oRoleDefinition.Name = "Custom Role Definition"
   collRoleDefinitions.Add(oRoleDefinition)
End Using

Hinweis

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

Siehe auch

Referenz

SPRoleDefinitionCollection Klasse

SPRoleDefinitionCollection-Member

Microsoft.SharePoint-Namespace