Codeausschnitt: Hinzufügen eines Zugriffssteuerungseintrags zu einem Metadatenobjekt mithilfe des Verwaltungsobjektmodells

Artikel
09/18/2014

Letzte Änderung: Freitag, 7. Mai 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Beschreibung
Voraussetzungen
So verwenden Sie dieses Beispiel

Beschreibung

Das folgende Codebeispiel veranschaulicht, wie Sie einem Metadatenobjekt (in diesem Beispiel einem Modell) mithilfe des BDC-Verwaltungsobjektmodell auf dem Server programmgesteuert einen Zugriffssteuerungseintrag hinzufügen können.

Hinweis
Mithilfe des BDC-Administrationsclient-Objektmodells können Sie auf ähnliche Weise einen externen Inhaltstyp auf dem Client erstellen.

Voraussetzungen

Microsoft SharePoint Server 2010 oder Microsoft SharePoint Foundation 2010 auf dem Server
Microsoft .NET Framework 3.5 und Microsoft Visual Studio auf dem Clientcomputer
Mindestens ein registrierter externer Inhaltstyp im Metadatenspeicher von BDC

So verwenden Sie dieses Beispiel

Starten Sie Visual Studio, und erstellen Sie ein C#-Konsolenanwendungsprojekt. Wählen Sie beim Erstellen des Projekts .NET Framework 3.5 aus.
Klicken Sie im Menü Ansicht auf Eigenschaftenseiten, um die Projekteigenschaften aufzurufen.
Wählen Sie auf der Registerkarte Build unter Zielplattform die Option Beliebige CPU aus.
Schließen Sie das Fenster mit den Projekteigenschaften.
Entfernen Sie im Projektmappen-Explorer unter Verweise sämtliche Projektverweise bis auf System und System.Core.
Fügen Sie dem Projekt die folgenden Verweise hinzu:
1. Microsoft.BusinessData
2. Microsoft.SharePoint
3. System.Web
Ersetzen Sie den automatisch generierten Code in Program.cs durch den Code am Ende dieses Verfahrens.
Ersetzen Sie den Zeichenfolgenwert "<siteUrl>" durch eine gültige SharePoint-Website-URL.
Ersetzen Sie "<EntityNamespace>" und "<EntityName>" durch den Namespace und den Entitätsnamen einer vorhandenen Entität.
Speichern Sie das Projekt.
Kompilieren Sie das Projekt, und führen Sie es aus.

using System;
using Microsoft.BusinessData.Infrastructure;
using Microsoft.BusinessData.MetadataModel;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
using Microsoft.SharePoint.BusinessData.Administration;
using Microsoft.SharePoint.BusinessData.Infrastructure;
using Microsoft.SharePoint.BusinessData.SharedService;

namespace Microsoft.SDK.SharePoint.Samples.Bdc.AddAccessControlEntry
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the Catalog for the SharePoint site.
            BdcService service =
                SPFarm.Local.Services.GetValue<BdcService>(
                String.Empty);
            SPSite site = new SPSite("<siteUrl>");
            SPServiceContext context = SPServiceContext.GetContext(site);

            AdministrationMetadataCatalog catalog =
                service.GetAdministrationMetadataCatalog(context);

            // Retrieve an existing Entity.
            Entity entity = catalog.GetEntity(
                "<EntityNamespace>", "<EntityName>");

            // Add Execute permissions for a specified user to the Entity.
            Console.WriteLine(
                "Type the user account to add Execute Rights Access: ");
            string userAccount = Console.ReadLine();

            IAccessControlList acl = entity.GetAccessControlList();
            Console.WriteLine(
                "Adding " + userAccount + 
                "with Execute and Set Permission rights to entity: " + entity.Name);
            IAccessControlEntry ace = new IndividualAccessControlEntry(
                BdcAccessControlList.TranslateFriendlyStringToEncodedClaim(
                userAccount),
                BdcRights.Execute | BdcRights.SetPermissions);
            acl.Add(ace);
            entity.SetAccessControlList(acl);
            // Copy entity permissions to its methods so that they can 
            // be executed by the added user.
            entity.CopyAclAcrossChildren();

            // Retrieve the LobSystem for this entity and add the user 
            // to it as well. This will allow the added user to access 
            // the external source for retrieving data.
            LobSystem lobSystem = entity.LobSystem;
            IAccessControlList lobSystemAcl = 
                lobSystem.GetAccessControlList();
            lobSystemAcl.Add(ace);
            lobSystem.SetAccessControlList(lobSystemAcl);
        }

    }
}