Readme_XmlManuInstructions

Artikel
12/15/2008

Aktualisiert: 05. Dezember 2005

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

Dieses Beispiel wird unter Windows 2000 und älteren Betriebssystemen nicht unterstützt.

Standardspeicherort:

drive:\Programme\Microsoft SQL Server\90\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.

Szenario

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 2005.

Anwendungsbereich	Features
Gesamt	XML, SQL Server-gehostete Webdienste

Voraussetzungen

Stellen Sie vor dem Ausführen des Beispiels sicher, dass die folgende Software installiert ist:

Microsoft SQL Server 2005 oder Microsoft SQL Server 2005 Express Edition (SQL Server Express). Sie können SQL Server Express kostenlos von der Website mit der Dokumentation und Beispielen zu SQL Server 2005 Express Edition abrufen.
Die AdventureWorks-Datenbank, die im Lieferumfang von SQL Server 2005 enthalten und auch auf der SQL Server Developer-Website verfügbar ist.
Die Beispiele zu SQL Server 2005-Datenbankmodul. Diese Beispiele sind in SQL Server 2005 enthalten. Sie können die aktuelle Version der Beispiele von der SQL Server Developer-Website downloaden.

.NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Das .NET Framework SDK ist kostenlos erhältlich. Siehe Installieren des .NET Framework SDK.

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

Ö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 anschließend 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.

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

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 <Systemlaufwerk>:\Programme\Microsoft SQL Server\100\Samples.

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" auf der MSDN-Website.

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

Beispielerstellung

Stellen Sie sicher, dass die AdventureWorks-Beispieldatenbank installiert ist.
Laden Sie in SQL Server Management Studio das Skript Scripts\install.sql, und führen Sie es aus. Führen Sie alternativ 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
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.

Installieren Sie den SVG-Viewer von http://www.adobe.co. 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:

Geben Sie im Menü Ausführen den folgenden Befehl ein: runas /user:Administrator cmd.
Geben Sie an der Eingabeaufforderung das Administratorkennwort ein.
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.

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

Führen Sie CS/XmlManuInstructions/bin/debug/XmlManuInstructions.exe aus.
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 2005 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

Ö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

Kommentar

Änderungsverlauf

Version	Verlauf
05. Dezember 2005	Geänderter Inhalt: Die Anweisungen zum Generieren einer Schlüsseldatei wurden geändert, einschließlich des Namens und Speicherortes der Schlüsseldatei.