Codeausschnitt: Ausführen der Associator- und Disassociator-Methodeninstanzen eines externen Inhaltstyps

Artikel
09/18/2014

Letzte Änderung: Donnerstag, 6. 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 eine Associator- und Disassociator-Methodeninstanz mit einem externen Inhaltstyp unter Verwendung des BDC-Laufzeitobjektmodells auf dem Server programmgesteuert ausführen.

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 Erstellen unter Zielplattform die Option Any 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. Microsoft.SharePoint.BusinessData
Ersetzen Sie den automatisch generierten Code in Program.cs durch den Code am Ende dieser Prozedur.
Ersetzen Sie die Werte für Entitätsname, LobSystem-Name und LobSystemInstance-Name durch gültige Werte.
Speichern Sie das Projekt.
Kompilieren Sie das Projekt, und führen Sie es aus.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.BusinessData.Runtime;
using Microsoft.BusinessData.MetadataModel;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
using Microsoft.SharePoint.BusinessData.SharedService;

namespace SDKSamples
{
    class Associate
    {
        // FKLessAssociateDisAssociate.
        public static void AssociateSalesOrderWithSalesReasonSample()
        {
            BdcService service = 
                SPFarm.Local.Services.GetValue<BdcService>(String.Empty);
            IMetadataCatalog catalog = 
                service.GetDatabaseBackedMetadataCatalog(
                SPServiceContext.Current);

            // Get entities.
            IEntity salesReasonEntity = catalog.GetEntity(
                "AdventureWorks", "SalesReason");
            IEntity salesOrderEntity = catalog.GetEntity(
                "AdventureWorks", "SalesOrder");

            // Get LOB System instance.
            ILobSystemInstance lobSystemInstance = 
                salesOrderEntity.GetLobSystem().GetLobSystemInstances()
                ["AdventureWorks"];

            // Get the source entity instance with ID 1 to use to navigate the association.
            IEntityInstance salesReasonInstance = 
                salesReasonEntity.FindSpecific(
                new Identity(1), 
                "Read Item", 
                lobSystemInstance, 
                OperationMode.Offline);
            IEntityInstance salesOrderInstance = 
                salesOrderEntity.FindSpecific(
                new Identity(44444), 
                "Read Item", 
                lobSystemInstance, 
                OperationMode.Offline);

            // Create a collection with the source instance.
            EntityInstanceCollection sourceInstances = 
                new EntityInstanceCollection(1);
            sourceInstances.Add(salesReasonInstance);

            // Get the association.
            IAssociation associator = 
                (IAssociation)salesOrderEntity.GetMethodInstance(
                "Sales Order by Reason Associator", 
                MethodInstanceType.Associator);

            // Associate.
            salesOrderEntity.Associate(
                sourceInstances, 
                salesOrderInstance, 
                associator, 
                lobSystemInstance);

            // Get the disassociator.
            IAssociation disassociator = 
                (IAssociation)salesOrderEntity.GetMethodInstance(
                "Sales Order by Reason Disassociator", 
                MethodInstanceType.Disassociator);

            // Disassociate.
            salesOrderEntity.Disassociate(
                sourceInstances, 
                salesOrderInstance, 
                disassociator, 
                lobSystemInstance);            
        }

    }
}