Share via

Readme_XmlManuInstructions-Beispiel

  • Artikel

[Dieses Thema ist eine Dokumentation zur Vorabversion und kann in zukünftigen Versionen geändert werden. Leere Themen sind als Platzhalter eingefügt. BITTE BEACHTEN SIE: Microsoft ist bestrebt, Ihnen möglichst viele Inhalte in deutscher Sprache anzubieten. Deshalb stellen wir Ihnen auch Dokumente zur Verfügung, die mit alternativen Verfahren übersetzt wurden. Der Inhalt der Dokumente dieser Vorabversion wurde zum Teil mithilfe solcher Verfahren übersetzt. Microsoft ist sich bewusst, dass ein auf diese Weise übersetztes Dokument nicht immer perfekt ist. Es kann Fehler in Bezug auf Wortwahl, Satzbau oder Grammatik enthalten. Für die Übersetzung der endgültigen Version dieses Inhalts werden herkömmliche Verfahren verwendet, sodass die Qualität der früherer Versionen entspricht.]

Dieses Beispiel funktioniert nur mit SQL Server 2005 und SQL Server 2008. In einer SQL Server-Version vor SQL Server 2005 kann das Beispiel nicht ausgeführt werden.

In der XMLManuInstructions-Beispielanwendung werden Onlineanleitungen zum Erstellen von Produkten gezeigt. Die Daten für diese Anwendungen werden aus den folgenden Spalten in der Microsoft SQL Server AdventureWorks-Datenbank abgerufen:

  • Instructions-Spalte mit XML-Typ in der Production.ProductModel-Tabelle
  • Diagram-Spalte mit XML-Typ in der Production.Illustration-Tabelle

Standardspeicherort:

C:\Programme\Microsoft SQL Server\100\Samples\Engine\XML\XmlManuInstructions.

Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für den Einsatz in einer Produktionsumgebung gedacht und wurden auch nicht in einer Produktionsumgebung getestet. Microsoft leistet keinen technischen Support für diese Beispiele. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Scenario

Ein Entwickler möchte eine Anwendung erstellen, die auf XML-basierte Produktionsanweisungen eines Webdienstes zugreift und diese anzeigt.

Sprachen

Transact-SQL, XML, XSD, XSLT, Visual C# und Visual Basic

Features

Das XmlManuInstructions-Beispiel verwendet die folgenden Features von SQL Server.

Anwendungsbereich Features

Allgemein

XML, SQL Server-gehostete Webdienste

Voraussetzungen

Vor dem Ausführen dieses Beispiels muss die folgende Software installiert werden:

  • Microsoft SQL Server oder Microsoft SQL Server Express (SQL Server Express). Sie können SQL Server Express kostenlos über die Website mit der Dokumentation und Beispielen zu SQL Server Express beziehen.
  • Die AdventureWorks2008R2-Datenbank, die auf der SQL Server Developer-Website zur Verfügung gestellt wird.
  • Die SQL Server Database Engine (Datenbankmodul)-Beispiele, die auf der SQL Server Developer-Website zur Verfügung gestellt werden.
  • .NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Sie können das .NET Framework SDK kostenlos erhalten. Informationen dazu finden Sie unter Installieren der .NET Framework-Dokumentation.

Erstellen des Beispiels

Generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen, falls Sie noch keine Schlüsseldatei mit starkem Namen erstellt haben.

So generieren Sie eine Schlüsseldatei mit starkem Namen

  1. Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und danach auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

    – oder –

    Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

  2. Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) vom aktuellen Verzeichnis im Eingabeaufforderungsfenster zu dem Ordner, in dem die Beispiele installiert werden.

    Hinweis

    Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <system_drive>:\Programme\Microsoft SQL Server\100\Samples.

  3. Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:

    sn -k SampleKey.snk

    Wichtig

    Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter .NET-Entwicklung von MSDN.

Zum Erstellen des Beispiels müssen Sie die folgenden Schritte durchführen:

Beispielerstellung

  1. Stellen Sie sicher, dass die AdventureWorks-Beispieldatenbank installiert ist.

  2. Laden Sie in SQL Server Management Studio das Skript Scripts\install.sql, und führen Sie es aus. Oder führen Sie dann den folgenden Befehl in einem Eingabeaufforderungsfenster aus:

    sqlcmd -E -I -i Scripts\install.sql

    Dieses Skript erstellt Folgendes:

    • Die gespeicherte Prozedur GetManuInstructions
    • Den HTTP-Endpunkt sql_AdvWorksEndPointManuInstrucions

  3. Klicken Sie im Windows-Explorer mit der rechten Maustaste auf den Ordner CS\XmlManuInstructions, in dem das Beispiel installiert wurde, klicken Sie auf Eigenschaften, klicken Sie auf die Registerkarte Webfreigabe, wählen Sie die Option Diesen Ordner freigeben aus, und klicken Sie dann zweimal auf OK. Hierdurch wird ein virtueller IIS-Ordner für das Beispiel erstellt, der für einen ordnungsgemäßen Betrieb der Anwendung benötigt wird.

  4. Installieren Sie den SVG-Viewer von der Adobe-Website. Achten Sie unbedingt darauf, auf Speichern unter anstelle von Öffnen zu klicken.

    Hinweis

    Um den Viewer installieren zu können, müssen Sie über Administratorprivilegien für Ihren Computer verfügen. Gehen Sie wie folgt vor, um den Viewer im Administratorkontext zu installieren, ohne sich von Ihrer aktuellen Sitzung abmelden zu müssen:

    1. Geben Sie im Menü Ausführen den folgenden Befehl ein: runas /user:Administrator cmd.
    2. Geben Sie an der Eingabeaufforderung das Administratorkennwort ein.
    3. Geben Sie in der Befehlsshell den Pfad zur Datei svgview.exe ein, und drücken Sie die EINGABETASTE, z. B. C:\downloads\svgview.exe.

    Hinweis

    Auch wenn Ihr Benutzerkonto mit Administratorprivilegien ausgestattet ist, müssen Sie das Installationsprogramm unter dem Konto namens "Administrator" ausführen. Andernfalls lässt sich das Installationsprogramm nicht starten.

  5. Erstellen Sie die Anwendung mithilfe von Microsoft Visual Studio 2005, oder geben Sie Folgendes in einem Eingabeaufforderungsfenster von .NET Framework oder Microsoft Visual Studio 2005 ein:

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\xmlmanuinstructions.sln

Ausführen des Beispiels

Zum Ausführen des Beispiels müssen Sie die folgenden Schritte durchführen:

Beispielausführung

  1. Führen Sie CS/XmlManuInstructions/bin/debug/XmlManuInstructions.exe aus.

  2. Geben Sie 7 als Wert für Product Model ID ein. Klicken Sie auf Show Instructions, um die vollständig gerenderten Produktionsanweisungen für das angegebene Modell anzuzeigen. Wenn Sie sich für das Format der SOAP-Anforderung interessieren, klicken Sie auf Show Request. Wenn Sie sich für das Format der SOAP-Antwort von SQL Server interessieren, klicken Sie auf Show Response. Wenn Sie sich für die XSLT-Datei interessieren, die die Anweisungen gerendert hat, klicken Sie auf Show XSL. Sie können in der ProductModel-Tabelle nach ProductModelID-Werten zu den Produkten suchen, zu denen XML-Produktionsanweisungen gespeichert sind.

Entfernen des Beispiels

Um das Beispiel zu entfernen, gehen Sie wie folgt vor:

Beispielentfernung

  1. Öffnen Sie die Datei Scripts\cleanup.sql in Management Studio, und führen Sie den Inhalt der Datei aus. Führen Sie alternativ den folgenden Befehl in einem Eingabeaufforderungsfenster aus: sqlcmd -E -I -i Scripts\cleanup.sql

Anmerkungen

Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für den Einsatz in einer Produktionsumgebung gedacht und wurden auch nicht in einer Produktionsumgebung getestet. Microsoft leistet keinen technischen Support für diese Beispiele. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden.