RoleDefinitionBindingCollection.Add-Methode

Ruft die Zeichenfolge ab, die auf dem Server für die Darstellung von A.M. verwendet wird.

Namespace:  Microsoft.SharePoint.Client
Assemblys:   Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client.Phone (in Microsoft.SharePoint.Client.Phone.dll)  Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)

Syntax

'Declaration
Public Sub Add ( _
    roleDefinition As RoleDefinition _
)
'Usage
Dim instance As RoleDefinitionBindingCollection
Dim roleDefinition As RoleDefinition

instance.Add(roleDefinition)

public void Add(
    RoleDefinition roleDefinition
)

Parameter

• roleDefinition
  Typ: Microsoft.SharePoint.Client.RoleDefinition

  Ein RoleDefinition -Objekt, das die Rollendefinition hinzufügen darstellt.

Ausnahmen

Ausnahme	Bedingung
SPException	Gast nicht erteilt werden, dass die Rolle oder Rollendefinition bereits hinzugefügt wird. Fehlercode:-2146232832.

Hinweise

Die übergeordnete Web der Rollendefinition hinzugefügt werden sollte der übergeordneten Web von vorhandenen Rollendefinitionen in der Auflistung identisch sein. Es muss sich nicht auf ein Nullverweis (Nothing in Visual Basic).

Beispiele

In diesem Codebeispiel erstellt eine neue Berechtigungsstufe und der Ankündigungsliste mit dieser Berechtigungsstufe ein Benutzer hinzugefügt.

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class RoleDefinitionBindingCollection_AddExample
    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Site collSite = clientContext.Site;
            Web site = clientContext.Web;

            // Set up permissions.
            BasePermissions permissions = new BasePermissions();
            permissions.Set(PermissionKind.ViewListItems);
            permissions.Set(PermissionKind.AddListItems);
            permissions.Set(PermissionKind.EditListItems);
            permissions.Set(PermissionKind.DeleteListItems);

            // Create a new role definition.
            RoleDefinitionCreationInformation rdcInfo = new RoleDefinitionCreationInformation();
            rdcInfo.Name = "Manage List Items";
            rdcInfo.Description = "Allows a user to manage list items";
            rdcInfo.BasePermissions = permissions;
            RoleDefinition roleDef = collSite.RootWeb.RoleDefinitions.Add(rdcInfo);

            // Create a new RoleDefinitionBindingCollection object.
            RoleDefinitionBindingCollection collRDB = new RoleDefinitionBindingCollection(clientContext);
            // Add the role to the collection.
            collRDB.Add(roleDef);

            // Get the list to work with and break permissions so its permissions can be managed directly.
            List targetList = site.Lists.GetByTitle("Announcements");
            targetList.BreakRoleInheritance(true, false);

            // Get the RoleAssignmentCollection for the target list.
            RoleAssignmentCollection collRoleAssign = targetList.RoleAssignments;
            // Add the user to the target list and assign the user to the new RoleDefinitionBindingCollection.
            RoleAssignment rollAssign = collRoleAssign.Add(site.CurrentUser, collRDB);

            clientContext.ExecuteQuery();

            Console.WriteLine("Security modified");
        }
    }
}

Siehe auch

Referenz

RoleDefinitionBindingCollection Klasse

RoleDefinitionBindingCollection-Member

Microsoft.SharePoint.Client-Namespace