Freigeben über


Durchsuchen, Suchen und Abrufen von Metadaten für SQL-Vorgänge mithilfe des SQL-Adapters

Dieser Abschnitt enthält Informationen zur Verwendung des BizTalk-Projekt-Add-Ins "Adapterdienst nutzen", des Assistenten zum Hinzufügen von Adaptermetadaten und des Visual Studio-Plug-Ins "Adapterdienstverweis hinzufügen". Mithilfe dieser Visual Studio-Komponenten können Sie:

  • Suchen Sie nach Vorgängen, für die Metadaten abgerufen werden sollen.

  • Suchen Sie nach Vorgängen, für die Metadaten abgerufen werden sollen.

  • Fügen Sie Nachrichtenschemas für ausgewählte Vorgänge und Portbindungskonfigurationsdateien zu einem BizTalk Server-Projekt hinzu, wenn Sie das Add-In Adapterdienst nutzen verwenden.

  • Fügen Sie eine WCF-Clientklasse oder einen WCF-Dienstvertrag (Schnittstelle) für ausgewählte Vorgänge und eine Konfigurationsdatei (app.config) zu einem Nicht-BizTalk-Programmierprojekt hinzu, wenn Sie das Add Adapter Service Reference Plug-In verwenden.

Hinweis

Das Add-In Adapterdienst nutzen, der Assistent zum Hinzufügen von Adaptermetadaten und das Add Adapter Service Reference Plug-In stellen beim Durchsuchen und Suchen nach Vorgängen im Wesentlichen die gleiche Schnittstelle dar, sodass alle drei Komponenten in den gleichen Themen behandelt werden.

Voraussetzungen

Sie müssen eine Verbindung mit SQL Server herstellen, bevor Sie Metadaten für Zielvorgänge durchsuchen, durchsuchen oder abrufen können. Informationen zum Herstellen einer Verbindung mit SQL Server, wenn Sie das Add-In Adapterdienst nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden, finden Sie unter Herstellen einer Verbindung mit SQL Server in Visual Studio mithilfe des Adapterdienst-Add-Ins.

Suchen nach Vorgängen

Sie können das Add-In Adapterdienst nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden, um nach ausgehenden und eingehenden Vorgängen zu suchen, die für SQL Server mithilfe des SQL-Adapters ausgeführt werden können.

Ausgehende Vorgänge

Mit dem SQL-Adapter können Clients die folgenden ausgehenden Vorgänge ausführen.

  • Einfüge-, Auswahl-, Aktualisierungs- und Löschvorgänge für Tabellen und Sichten.

  • Legen Sie<column_name> Vorgänge für Tabellen und Sichten fest. Dieser Vorgang wird für Tabellen verfügbar gemacht, die Spalten von varchar(max), nvarchar(max) oder varbinary(max) enthalten. Solche Vorgänge ermöglichen das Streaming großer Objekte.

  • Gespeicherte Prozeduren, sowohl schwach als auch stark typisiert als Vorgänge.

  • Skalar- und Tabellenwertfunktionen als Vorgänge.

    Der Adapter macht auch die generischen ausgehenden Vorgänge wie ExecuteReader, ExecuteScalar und ExecuteNonQuery auf Stammebene verfügbar.

Eingehende Vorgänge

Mit dem SQL-Adapter können Clients die folgenden eingehenden Vorgänge ausführen.

  • Abrufvorgang zum Empfangen von abrufbasierten Datenänderungsmeldungen von SQL Server. Die für diesen Vorgang empfangenen Nachrichten sind nicht stark typisiert.

  • TypedPolling-Vorgang, um abrufbasierte Datenänderungsmeldungen von SQL Server zu empfangen. Die für diesen Vorgang empfangenen Nachrichten sind stark typisiert.

  • Benachrichtigungsvorgang zum Empfangen von Abfragebenachrichtigungen von SQL Server.

Hinweis

Der Adapter unterstützt auch einen eingehenden XmlPolling-Vorgang, um das Abrufen SQL Server Datenbank mithilfe von SELECT-Anweisungen und gespeicherten Prozeduren, die eine FOR XML-Klausel enthalten, zu ermöglichen. Der Adapter macht jedoch keinen bestimmten eingehenden Vorgang dafür verfügbar. Weitere Informationen zu XmlPolling finden Sie unter Empfangen von Abrufnachrichten mithilfe von SELECT-Anweisungen mit der FOR XML-Klausel von SQL mithilfe von BizTalk Server.

Weitere Informationen zu diesen Vorgängen finden Sie unter Herstellen einer Verbindung mit einem SAP-System mithilfe des Adapters.

Hinweis

Mithilfe des Add-Ins Adapterdienst nutzen oder Des Adapterdienstverweis-Plug-Ins hinzufügen können Sie Kategorie- und Vorgangsknoten mithilfe einer Windows-Schnittstelle durchsuchen.

Weitere Informationen zum Durchsuchen von Metadaten finden Sie unter Abrufen von Metadaten für SQL Server Vorgänge in Visual Studio mithilfe des SQL-Adapters.

So durchsuchen Sie ausgehende Vorgänge in SQL Server
  1. Stellen Sie eine Verbindung mit SQL Server her, indem Sie das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit SQL Server in Visual Studio mithilfe des Adapterdienst-Add-Ins nutzen.

  2. Wählen Sie in der Liste Vertragstyp auswählen für ausgehende Vorgänge die Option Client (Ausgehende Vorgänge) aus.

  3. Im Feld Kategorie auswählen werden die Artefakte aufgelistet, die in der SQL Server Datenbank verfügbar sind, mit der Sie eine Verbindung herstellen. Klicken Sie auf ein Artefakt, um die für dieses Artefakt verfügbaren Vorgänge im Feld Verfügbare Kategorien und Vorgänge anzuzeigen.

    Tipp

    Sie können direkt zum "unmittelbaren" Kategorieknoten oder Unterkategorieknoten in der Struktur wechseln, indem Sie den Namen des Artefakts eingeben, während sich der Fokus auf der Strukturansicht im Feld Kategorie auswählen befindet. Um beispielsweise zum Knoten Employee-Tabelle zu springen, behalten Sie den Fokus auf dem Knoten Tabellen , und geben Sie dann ein Employee.

    Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen". Der Stammknoten (/) ist ausgewählt, und die unter dem Stammknoten verfügbaren allgemeinen Kategorieknoten werden im Feld Verfügbare Kategorien und Vorgänge aufgeführt.

    Verfügbare Vorgänge und Kategorien auf Stammebene

    Hinweis

    Die Standard-SQL Server Vorgänge wie ExecuteReader, ExecuteScalar und ExecuteNonQuery sind auch auf Stammebene verfügbar. Weitere Informationen zu diesen Vorgängen finden Sie unter Unterstützung für ExecuteNonQuery-, ExecuteReader- und ExecuteScalar-Vorgänge.

  4. Klicken Sie auf den Knoten Prozeduren, um die in der SQL Server-Datenbank verfügbaren Prozeduren anzuzeigen. In der folgenden Abbildung wird im Feld Kategorie auswählen der Knoten Prozeduren ausgewählt, und die entsprechenden Prozeduren werden im Feld Verfügbare Kategorien und Vorgänge aufgeführt.

    Durchsuchen von Prozeduren im SQL Server

    Hinweis

    Die gleichen Prozeduren, die unter dem Knoten Prozeduren aufgeführt sind, sind auch unter dem Knoten Stark typisierte Prozeduren verfügbar. Der Unterschied besteht in der Art und Weise, wie das Schema generiert wird. Bei einer Prozedur unter dem Knoten Prozedur ist das Schema schwach typisiert. Für eine Prozedur unter dem Knoten Strongly-Typed Procedure ist das Schema jedoch stark typisiert. Ein stark typisiertes Schema ist nützlich, wenn Sie das Schema eines Vorgangs einem anderen Vorgang mithilfe des BizTalk-Mappers zuordnen möchten, da das Schema zur Entwurfszeit beim Erstellen des BizTalk-Projekts verfügbar ist. Bei schwach typisierten Prozeduren wird das Schema für die Prozedur zur Laufzeit als Teil der Antwortnachricht empfangen.

  5. Klicken Sie auf den Knoten Tabellen, um die Tabellen in der SQL Server-Datenbank anzuzeigen. Erweitern Sie alternativ den Knoten Tabellen .

  6. Klicken Sie auf einen Tabellennamen, um die für die Tabelle unterstützten Vorgänge anzuzeigen.

    Die folgende Abbildung zeigt eine Liste der Tabellen im Feld Kategorie auswählen . Im Feld Verfügbare Kategorien und Vorgänge werden die vorgänge aufgelistet, die für eine ausgewählte Tabelle unterstützt werden.

    Durchsuchen von Tabellen in einer SQL Server Datenbank

    Hinweis

    Wenn eine SQL Server Tabelle Spalten vom Typ varchar(max), nvarchar(max) und varbinary(max) enthält, macht der Adapter auch einen bestimmten Vorgang zum Aktualisieren von Daten in dieser Spalte verfügbar. Der Name dieses Vorgangs lautet Set<column_name>. Wenn die Tabelle beispielsweise die Spalte "Job_Description" vom Typ varchar(MAX) aufweist, lautet der Name des Vorgangs "SetJob_Description".

  7. Um die Ansichten in der SQL Server-Datenbank anzuzeigen, klicken Sie auf den Knoten Ansichten. Erweitern Sie alternativ den Knoten Ansichten .

  8. Klicken Sie auf einen Ansichtsnamen, um die in der Ansicht unterstützten Vorgänge anzuzeigen.

    Die folgende Abbildung zeigt eine Liste von Ansichten im Feld Kategorie auswählen . Im Feld Verfügbare Kategorien und Vorgänge werden die vorgänge aufgelistet, die für eine ausgewählte Ansicht unterstützt werden.

    Durchsuchen von Ansichten in einer SQL Server-Datenbank

    Hinweis

    Wenn eine Ansicht Spalten vom Typ varchar(max), nvarchar(max) und varbinary(max) enthält, macht der Adapter auch einen bestimmten Vorgang verfügbar, um Daten in dieser Spalte zu aktualisieren. Der Name dieses Vorgangs lautet Set<column_name>. Wenn die Tabelle beispielsweise die Spalte "Job_Description" vom Typ varchar(max) aufweist, lautet der Name des Vorgangs "SetJob_Description".

  9. Klicken Sie auf den Knoten Skalarfunktionen, um die Liste der skalaren Funktionen anzuzeigen, die in der SQL Server-Datenbank im Feld Verfügbare Kategorien und Vorgänge definiert sind.

    In der folgenden Abbildung ist der Knoten Skalarfunktionen im Feld Kategorie auswählen ausgewählt, und die entsprechenden Funktionen werden im Feld Verfügbare Kategorien und Vorgänge aufgeführt.

    Durchsuchen von Skalarfunktionen in SQL Server

  10. Um die Liste der Tabellenwertfunktionen anzuzeigen, die in der SQL Server-Datenbank im Feld Verfügbare Kategorien und Vorgänge definiert sind, klicken Sie auf den Knoten Tabellenwertfunktionen.

    In der folgenden Abbildung ist im Feld Kategorie auswählen der Knoten Tabellenwertfunktionen ausgewählt, und die entsprechenden Funktionen werden im Feld Verfügbare Kategorien und Vorgänge aufgeführt.

    Tabellenwertfunktionen in SQL Server

So durchsuchen Sie eingehende Vorgänge in SQL Server
  1. Stellen Sie eine Verbindung mit SQL Server her, indem Sie das Add-In Adapterdienst nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit SQL Server in Visual Studio mithilfe des Adapterdienst-Add-Ins nutzen.

  2. Wählen Sie in der Liste Vertragstyp auswählen für eingehende Vorgänge die Option Dienst (Eingehende Vorgänge) aus.

  3. Alle vom SQL-Adapter unterstützten eingehenden Vorgänge sind auf dem Stammknoten verfügbar. Klicken Sie auf den Stammknoten (/), um die verfügbaren eingehenden Vorgänge anzuzeigen.

    133732c0-ca8f-4e57-8a70-ba4fb561a37bVom Adapter

Suchen nach Vorgängen

Sie können das Add-In Adapterdienst nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden, um in der SQL Server-Datenbank nach bestimmten Artefakten zu suchen. Bei der Suche nach SQL Server Metadaten führt der SQL-Adapter Folgendes aus:

  • Unterstützt Wildcard- und Escapezeichen im Suchausdruck.

  • Aktiviert die Suche sofort unter dem Knoten, auf dem der Suchvorgang ausgeführt wird. Um beispielsweise nach einer Tabelle zu suchen, müssen Sie unter \Table suchen. Die Suche mit mehreren Ebenen wird nicht unterstützt.

    In der folgenden Tabelle sind die Sonderzeichen aufgeführt, die für die Suche nach Artefakten und deren Interpretation durch den SQL-Adapter verwendet werden können.

Sonderzeichen Interpretation Beispiel
_ (Unterstrich) Entspricht genau einem Zeichen "A_" entspricht AB, AC, AD.
% Entspricht „0“ (null) oder mehreren Zeichen. "A%" entspricht A, AB, AC.
[ ] - Entweicht die besondere Bedeutung von % und _
– Gibt einen Bereich oder einen Zeichensatz an, der vorhanden sein soll
- %[%]% entspricht allen Namen, die ein %-Symbol enthalten.
- [a-f] entspricht allen Namen, die Zeichen zwischen (und einschließlich) "a" und "f" enthalten.
- [abc] entspricht allen Namen mit den Zeichen "a", "b" und "c".
[^] Gibt einen Bereich oder einen Satz von Zeichen an, die nicht vorhanden sein sollen. - [^a-f] entspricht allen Namen, die keine Zeichen zwischen (und einschließlich) "a" und "f" enthalten.
- [^abc] entspricht allen Namen, die keine Zeichen "a", "b" und "c" enthalten.

Hinweis

Das Escapezeichen ist ein Zeichen, das vor einem Feldhalterzeichen platziert wird, um anzugeben, dass der Feldhalter als reguläres Zeichen und nicht als Feldhalter interpretiert werden soll.

Weitere Informationen finden Sie unter Abrufen von Metadaten für SQL Server Vorgänge in Visual Studio mithilfe des SQL-Adapters.

Führen Sie die folgenden Schritte aus, um Metadaten in SQL Server mithilfe des Add-Ins Adapterdienst nutzen zu suchen.

So durchsuchen Sie Metadaten in SQL Server

  1. Stellen Sie eine Verbindung mit SQL Server her, indem Sie das Add-In "Adapterdienst nutzen", den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit SQL Server in Visual Studio mithilfe des Add-Ins "Adapterdienst nutzen".

  2. Wählen Sie in der Liste Vertragstyp auswählen den Vertragstyp basierend darauf aus, ob Sie nach eingehenden oder ausgehenden Vorgängen suchen.

  3. Klicken Sie im Feld Kategorie auswählen auf den Kategorieknoten, unter dem Sie nach einem bestimmten Artefakt suchen möchten. Wenn Sie beispielsweise nach einer Tabelle suchen möchten, klicken Sie auf den Knoten Tabellen .

  4. Geben Sie im Feld Kategorie suchen einen Suchausdruck ein, um nach einem bestimmten Artefakt zu suchen. Um beispielsweise nach Tabellen zu suchen, die "Customer" im Namen enthalten, geben Sie ein %Customer%.

    Hinweis

    Bei der Suchzeichenfolge wird die Groß-/Kleinschreibung beachtet.

  5. Um die Suche zu starten, klicken Sie auf die Schaltfläche mit dem Rechtspfeilsymbol. Nach Abschluss der Suche werden im Feld Verfügbare Kategorien und Vorgänge die Artefakte aufgelistet, die die Suchkriterien erfüllen.

    Die folgende Abbildung zeigt die SQL Server Tabellen, die "Kunde" im Namen enthalten.

    Suchen von Metadaten in SQL Server

Generieren eines Schemas für BizTalk-Projekte

Sie können das Add-In Adapterdienst nutzen oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden, um ein Schema für ausgewählte SQL Server Artefakte zu generieren. Nachdem Sie nach den Artefakten gesucht haben, die Sie aufrufen möchten, können Sie ein Schema für diese Artefakte generieren und dem Schema entsprechende Nachrichten senden, um SQL Server.

Hinweis

Sie können Kategorieknoten auswählen, um alle Vorgänge in der Unterstruktur dieser Kategorie zurückzugeben. Sie können z. B. eine gesamte Tabelle (zum Generieren eines Schemas für alle Vorgänge in der Tabelle) oder bestimmte Vorgänge für eine Tabelle (z. B. Einfügen und Löschen) auswählen, um ein Schema nur für diese Vorgänge in einer Tabelle zu generieren. Weitere Informationen zu den Knoten finden Sie unter Metadatenknoten-IDs.

So generieren Sie ein Schema für SQL Server Artefakte

  1. Stellen Sie eine Verbindung mit SQL Server her, indem Sie das Add-In "Adapterdienst nutzen" oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden. Anweisungen finden Sie unter Herstellen einer Verbindung mit SQL Server in Visual Studio mithilfe des Add-Ins "Adapterdienst nutzen".

    Wichtig

    Um ein Schema für die Ausführung von Vorgängen mit BizTalk Server zu generieren, müssen Sie die EnableBizTalkCompatibilityMode-Bindungseigenschaft auf True festlegen. Sie müssen diese Bindungseigenschaft festlegen, während Sie eine Verbindung mit der SQL Server-Datenbank herstellen.

  2. Wählen Sie in der Liste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie ein Schema für eingehende oder ausgehende Vorgänge generieren.

  3. Klicken Sie auf den Kategorieknoten, für den Sie Metadaten generieren möchten. Wenn Sie beispielsweise Metadaten für eine Tabelle generieren möchten, klicken Sie auf Tabellen.

  4. Erweitern Sie den Kategorieknoten, und wählen Sie das bestimmte Element innerhalb des Knotens aus, für das Sie Metadaten generieren möchten. Um beispielsweise Metadaten für Vorgänge für die Tabelle "CustomerTable" zu generieren, erweitern Sie den Knoten Tabellen , und klicken Sie dann auf CustomerTable.

  5. Wählen Sie im Feld Verfügbare Kategorien und Vorgänge die Vorgänge aus, die Sie für SQL Server ausführen möchten, und klicken Sie dann auf Hinzufügen. Die ausgewählten Vorgänge werden im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt. Zum Ausführen von Insert- und Select-Vorgängen in der Tabelle "CustomerTable" klicken Sie beispielsweise auf die Vorgangsnamen, und klicken Sie dann auf Hinzufügen.

    Die folgende Abbildung zeigt das Add-In "Adapterdienst nutzen", in dem die ausgewählten Vorgänge aufgelistet sind.

    Abrufen von Metadaten aus SQL Server

    Wenn Sie ein Schema für mehrere Vorgänge generieren möchten, gibt es möglicherweise einige doppelte Elementdefinitionen unter diesen Schemas, die bei der Kompilierung des BizTalk-Projekts einen Fehler verursachen können. Betrachten Sie beispielsweise ein Szenario, in dem Sie ein Schema für einen Vorgang "Op1" generieren. Das Schema für "Op1" enthält einen Parameter des Datentyps "CT1". Nachdem Sie das Schema für "Op1" generiert haben, schließen Sie das Add-In "Adapterdienst nutzen" und öffnen es erneut, um das Schema für einen anderen Vorgang "Op2" zu generieren. Angenommen, "Op2" enthält auch einen Parameter des Datentyps "CT1". Nachdem Sie das Add-In "Adapterdienst nutzen" beendet und das Projekt kompiliert haben, erhalten Sie Kompilierungsfehler, da der komplexe Datentyp "CT1" zweimal in verschiedenen XSD-Dateien definiert ist. In solchen Situationen empfehlen wir Folgendes:

    • Generieren Sie ein Schema für alle Vorgänge in einer einzelnen Ausführung des Add-Ins "Adapterdienst nutzen". Dadurch wird sichergestellt, dass das Add-In "Adapter-Dienst nutzen" nur eine Definition für den komplexen Datentyp "CT1" generiert.

    • Wenn Sie ein Schema für mehrere Vorgänge für verschiedene Ausführungen des Add-Ins "Adapterdienst nutzen" generieren möchten, aktivieren Sie das Kontrollkästchen Eindeutige Schematypen generieren , damit die generierten XSD-Dateien eindeutige Namespaces für den komplexen Datentyp "CT1" enthalten.

  6. Klicken Sie auf OK. Die Schemadatei wird mit einer XSD-Erweiterung am gleichen Speicherort wie das BizTalk-Projekt gespeichert.

    Hinweis

    Wenn Sie das Add-In Adapterdienst nutzen verwenden, um Metadaten für SQL Server Artefakte zu generieren, werden die Dateien standardmäßig mit einer bestimmten Benennungskonvention erstellt. Die generierte WSDL enthält ein fileNameHint-Anmerkungstag , das den Namen enthält, der der XSD-Datei zugewiesen werden soll. Beispielsweise folgt ein Dateinamenhinweis für eine Schemadatei für den Tabellenvorgang der Konvention TableOperation.<schema>.<tablename>. Wenn Sie den Namen der generierten XSD-Datei anpassen möchten, können Sie im Feld Dateinamepräfix ein Präfix angeben. Schließlich wird der Name einer XSD-Datei als Dateinamepräfix + DateinameHint + eindeutige ganze Zahl (falls erforderlich, um sicherzustellen, dass der Dateiname eindeutig ist).

    Hinweis

    Das Add-In Adapterdienst nutzen erstellt auch eine Bindungsdatei (eine XML-Datei), die die Bindungseigenschaften enthält, die Sie beim Generieren des Schemas für einen Vorgang und die SOAP-Aktion zum Aufrufen des Vorgangs angegeben haben. Sie können diese Bindungsdatei in die BizTalk Server-Verwaltungskonsole importieren, um einen WCF-Custom Port oder einen BizTalk SQL-Adapterport mit dem Verbindungs-URI, den Bindungseigenschaften und dem SOAP-Aktionssatz zu erstellen. Weitere Informationen finden Sie unter Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für die Verwendung des SQL-Adapters.

    Sie haben erfolgreich Metadaten für SQL Server Artefakte generiert. Sie können die Metadaten verwenden, um Nachrichten an SQL Server zu senden, um bestimmte Vorgänge auszuführen. Weitere Informationen zum Ausführen dieser Vorgänge finden Sie unter Entwickeln von BizTalk-Anwendungen mithilfe des SQL-Adapters .

Generieren eines WCF-Clients oder WCF-Dienstvertrags mithilfe des Add Adapter Service Reference Plug-In

Sie können das Add Adapter Service Reference Plug-In verwenden, um entweder WCF-Clientcode für ausgehende Vorgänge oder WCF-Dienstcode für die eingehenden Vorgänge zu generieren.

So generieren Sie eine WCF-Clientklasse oder einen Dienstvertrag für SQL Server Vorgänge

  1. Wählen Sie im Add Adapter Service Reference Plug-In aus der Dropdownliste Vertragstyp auswählen den Vertragstyp aus, je nachdem, ob Sie eingehende oder ausgehende Vorgänge ausführen.

  2. Suchen Sie nach Kategorien (z. B. einer Datenbanktabelle) oder nach den spezifischen Vorgängen, für die Sie einen WCF-Client (oder einen WCF-Dienstvertrag) generieren möchten.
    Wenn Sie beispielsweise nach den Vorgängen in der Tabelle Employee suchen möchten, klicken Sie im Feld Kategorie auswählen :

    1. Erweitern Sie den Stammknoten (/), um die Kategorien anzuzeigen, unter denen die Vorgänge für eine SQL Server Datenbank angezeigt werden.

    2. Erweitern Sie unter dem Stammknoten den Knoten Tabellen , um die verfügbaren Tabellen anzuzeigen.

  3. Klicken Sie auf den Knoten Mitarbeitertabelle , und wählen Sie im Feld Verfügbare Kategorien und Vorgänge die Vorgänge oder Kategorien aus, für die Sie einen WCF-Client (oder WCF-Dienstvertrag) generieren möchten, und klicken Sie dann auf Hinzufügen. Die ausgewählten Vorgänge werden im Feld Hinzugefügte Kategorien und Vorgänge aufgeführt.

    Die folgende Abbildung zeigt das Add Adapter Service Reference Plug-In mit den ausgewählten Vorgängen Einfügen und Auswählen für die Tabelle Employee.

    Generieren eines WCF-Clients oder Eines Dienstvertrags

    Wichtig

    Abhängig von den von Ihnen ausgewählten ausgehenden Vorgängen (oder Kategorien) können mehrere WCF-Clientklassen generiert werden. Weitere Informationen finden Sie unter Generieren eines WCF-Clients oder WCF-Dienstvertrags für SQL Server Artefakte.

  4. Für die meisten Szenarien sind die Standardserialisierungsoptionen ausreichend. Bei Bedarf können Sie jedoch mehrere Aspekte des generierten Codes und des verwendeten Serialisierungstyps steuern. So legen Sie diese Optionen fest:

    1. Klicken Sie auf Erweiterte Optionen , um das Feld Erweiterte Optionen zu öffnen.

    2. Wählen Sie im Feld Erweiterte Optionen unter Optionen für generierten Proxy auswählen die gewünschten Optionen aus. Sie können beispielsweise auswählen, ob asynchrone Methoden für den WCF-Client generiert werden, oder die Generierung einer Konfigurationsdatei deaktivieren.

    3. Wählen Sie unter Serialisierungsprogramm das Serialisierungsprogramm aus, das verwendet werden soll.

      Die folgende Abbildung zeigt das Feld Erweiterte Optionen mit der Standardauswahl (Auto ist für das Serialisierungsprogramm ausgewählt, und es sind keine anderen Optionen ausgewählt).

      Die Standardeinstellungen des Felds

      Die Optionen, die Sie im Feld Erweiterte Optionen konfigurieren können, entsprechen einigen der Verfügbaren Optionen, wenn Sie das ServiceModel Metadata Utility Tool (svcutil.exe) verwenden. Weitere Informationen zu diesen Optionen finden Sie unter ServiceModel Metadata Utility Tool (Svcutil.exe).

  5. Klicken Sie auf OK. Das Add Adapter Service Reference Plug-In speichert die WCF-Clientklasse (oder WCF-Dienstschnittstelle) und den Hilfscode für die Vorgänge und Kategorien, die Sie in Ihrem Projektverzeichnis ausgewählt haben. Standardmäßig wird auch eine Konfigurationsdatei gespeichert. Für eingehende und ausgehende Vorgänge werden geringfügig unterschiedliche Dateien generiert. weitere Informationen finden Sie unter Generieren eines WCF-Clients oder WCF-Dienstvertrags für SQL Server Artefakte.

    Sie können einen beliebigen Knoten auswählen, der im Feld Verfügbare Kategorien und Vorgänge aufgeführt ist. Wenn Sie einen Kategorieknoten auswählen, werden alle vorgänge, die unter diesem Knoten und seinen Unterknoten verfügbar sind, ausgewählt. Um beispielsweise einen WCF-Client für alle Vorgänge zu generieren, die für die Tabelle Employee angezeigt werden, können Sie den Knoten Mitarbeiter auswählen.

Weitere Informationen

Abrufen von Metadaten für SQL Server Vorgänge in Visual Studio mithilfe des SQL-Adapters