Codeausschnitt: Ausführen der BulkAssociationNavigator-Methodeninstanz 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 BulkAssociationNavigator-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.MetadataModel;
using Microsoft.BusinessData.MetadataModel.Collections;
using Microsoft.BusinessData.Runtime;
using System.Diagnostics;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
using Microsoft.SharePoint.BusinessData.SharedService;

namespace SDKSamples
{
    class Methods
    {
        //Foreign Key Based BulkAssociationNavigator.
        public static void BulkAssociationNavigatorSample()
        {
                BdcService service = 
                    SPFarm.Local.Services.GetValue<BdcService>
                    (String.Empty);
                IMetadataCatalog catalog = 
                    service.GetDatabaseBackedMetadataCatalog(
                    SPServiceContext.Current);

                // Get entities.
                IEntity customerEntity = 
                    catalog.GetEntity("AdventureWorks", "Customer");
                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 customer1 = 
                    customerEntity.FindSpecific(
                    new Identity(1), 
                    "Read Item", 
                    lobSystemInstance, 
                    OperationMode.Offline);
                IEntityInstance customer2 = 
                    customerEntity.FindSpecific(
                    new Identity(2), 
                    "Read Item", 
                    lobSystemInstance, 
                    OperationMode.Offline);

                // Get the association.
                IAssociation association = 
                    (IAssociation)salesOrderEntity.GetMethodInstance(
                    "Bulk Customers Sales Orders", 
                    MethodInstanceType.BulkAssociationNavigator);

                // Create a collection with the entity instance.
                EntityInstanceCollection sourceInstances1 = 
                    new EntityInstanceCollection(1);
                sourceInstances1.Add(customer1);
                EntityInstanceCollection sourceInstances2 = 
                    new EntityInstanceCollection(1);
                sourceInstances2.Add(customer2);

                IList<EntityInstanceCollection> entityInstanceCollectionList = 
                    new List<EntityInstanceCollection>(2);
                entityInstanceCollectionList.Add(sourceInstances1);
                entityInstanceCollectionList.Add(sourceInstances2);

                IEntityInstanceEnumerator associatedInstances = null;
                try
                {
                    // Navigate the association.
                    associatedInstances = 
                        salesOrderEntity.FindAssociatedMultiple(
                        entityInstanceCollectionList, 
                        association, 
                        lobSystemInstance, 
                        OperationMode.Offline);

                    // List all sales orders for customer 1.
                    Debug.WriteLine(
                        "Listing customer's 1 sales orders ID and dates:");
                    while (associatedInstances.MoveNext())
                    {
                        Debug.WriteLine(
                            String.Format(
                            "Id: {0}, OrderDate: {1}", 
                            associatedInstances.Current["SalesOrderID"], 
                            associatedInstances.Current["OrderDate"]));
                    }
                }
                finally
                {
                    // Ensure the enumerator is closed.
                    if (associatedInstances != null)
                    {
                        associatedInstances.Close();
                    }
                }
            }
        }       
    }
}