Readme_XmlOnlineCatalog

Aktualisiert: 05. Dezember 2005

Die XMLOnlineCatalog-Beispielanwendung zeigt Informationen zu bestimmten Produkten an. Dieses Beispiel lädt Informationen aus folgenden Spalten in der SQL Server AdventureWorks-Datenbank:

• CatalogDescription-Spalte vom Datentyp xml in der Production.ProductModel-Tabelle
• LargePhoto-Spalte in der Production.ProductPhoto-Tabelle

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

Das standardmäßige Installationsverzeichnis ist Laufwerk:\Programme\Microsoft SQL Server\90\Samples\Engine\XML\XmlOnlineCatalog.

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 XML-basierte Produktbeschreibungen von einem Webdienst abrufen, der von SQL Server gehostet wird.

Sprachen

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

Features

Das XmlOnlineCatalog-Beispiel verwendet die folgenden Features von SQL Server 2005.

Anwendungsbereich	Features
Gesamt	XML, SQL Server-gehostete Webdienste

Voraussetzungen

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

• SQL Server 2005 oder SQL Server 2005 Express Edition. SQL Server Express erhalten Sie kostenlos auf der SQL Server Express-Downloadsite.
• 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. Weitere Informationen finden Sie unter 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

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

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

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

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

Beispielerstellung

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

2. Laden und führen Sie in SQL Server Management Studio das Skript scripts\install.sql aus, oder führen Sie den folgenden Befehl an einer Eingabeaufforderung aus:

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

   Dieses Skript erstellt Folgendes:

   • GetProductDescription (gespeicherte Prozedur)
   • sql_ProductCatalog HTTP-Endpunkt

3. Klicken Sie im Windows-Explorer mit der rechten Maustaste auf den Ordner CS\XmlOnlineCatalog, in dem das Beispiel installiert wurde, klicken Sie auf Eigenschaften, klicken Sie auf die Registerkarte Webfreigabe, klicken Sie auf die Option Diesen Ordner freigeben, 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. Kompilieren Sie die Anwendung mithilfe der bereitgestellten Microsoft Visual Studio-Projektmappe, oder führen Sie den folgenden Befehl an einer .NET Framework- oder Microsoft Visual Studio 2005-Eingabeaufforderung aus:

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

Ausführen des Beispiels

Um das Beispiel auszuführen, gehen Sie wie folgt vor:

Beispielausführung

1. Führen Sie die Anwendung CS\XmlOnlineCatalog\bin\debug\XmlOnlineCatalog.exe aus.

2. Geben Sie 19 als Wert für die ProductModelID ein, und klicken Sie auf Show Description. Wenn Sie weitere Informationen zum Format der SOAP-Anforderung erhalten möchten, klicken Sie auf Show Request. Wenn Sie weitere Informationen zum Format der SOAP-Antwort von SQL Server 2005 erhalten möchten, klicken Sie auf Show Response. Wenn Sie weitere Informationen zu der XSLT-Datei erhalten möchten, die die Anweisungen gerendert hat, klicken Sie auf Show XSL. Sie können in der ProductModel-Tabelle nach anderen ProductModelID-Werten suchen, für die die XML-Katalogbeschreibung gespeichert wird.

Entfernen des Beispiels

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

Beispielentfernung

1. Öffnen Sie die Datei Scripts\Cleanup.sql mithilfe von SQL Server Management Studio, und führen Sie den Inhalt der Datei aus. Führen Sie alternativ den folgenden Befehl an der Eingabeaufforderung aus:

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

Kommentar

Siehe auch

Konzepte

XML-Beispiele

Hilfe und Informationen

Informationsquellen für SQL Server 2005

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