Hello World Ready-Beispiel

Artikel
12/15/2008

Aktualisiert: 05. Dezember 2005

Das Hello World Ready-Beispiel veranschaulicht die grundlegenden Vorgänge, die beim Erstellen, Bereitstellen und Testen einer einfachen gespeicherten World-Ready-Prozedur auf der Basis einer CLR-Integration (Common Language Runtime) ausgeführt werden müssen. Eine World-Ready-Komponente lässt sich problemlos in verschiedene Sprachen für unterschiedliche Märkte in aller Welt lokalisieren, ohne den Quellcode der Komponente zu ändern. Diese Beispiel zeigt außerdem, wie Sie Daten über einen Ausgabeparameter und einen Datensatz, der dynamisch von der gespeicherten Prozedur erstellt und an den Client zurückgegeben wird, zurückgeben können.

Dieses Beispiel ist fast identisch mit dem Hello World-Beispiel, die Anwendung ist jedoch einfacher und sicherer zu lokalisieren. Das Ändern von lokalisiertem Text erfordert Folgendes:

Ändern einer XML-Datei (die Datei RESX) für die bestimmte Kultur im Ressourcenverzeichnis
Erstellen der Ressourcendatei der Kultur mithilfe von resgen
Erstellen der aktualisierten Satelliten-DLL für diese Kultur
Löschen und Hinzufügen dieser Assembly in SQL Server

Der Quellcode und die Assembly für die eigentliche gespeicherte CLR-Prodezur bleiben unverändert. Ein im Ressourcenverzeichnis zur Verfügung gestelltes build.cmd-Skript zeigt, wie die Ressourcenassemblys kompiliert und verknüpft werden.

Obwohl der Quellcode der Anwendung einen Ressourcen-Manager auf der Basis der aktuell ausgeführten Assembly erstellt, müssen Sie die kulturneutralen Ressourcen nicht in die DLL einbetten, die die gespeicherte Prozedur enthält. Das in der AssemblyInfo.cs- oder in der AssemblyInfo.vb-Datei verwendete System.Resources.NeutralResourcesLanguage-Attribut lässt die Existenz der kulturneutralen Ressource in der Satelliten-DLL zu. Es empfiehlt sich, für diesen Zweck eine separate DLL zu verwenden, damit die primäre DLL, in der sich die gespeicherte CLR-Prozedur befindet, nicht geändert werden muss, wenn lokalisierter Text hinzugefügt oder geändert werden muss. Dies erweist sich vor allem für benutzerdefinierte CLR-Typen als hilfreich, die Spalten und andere Abhängigkeiten beinhalten könnten, die es schwer machen würden, den Typ zu löschen und erneut hinzuzufügen.

Normalerweise müssen die Satelliten-DLL-Versionen mit der Version der Hauptassembly übereinstimmen. Sie können jedoch das SatelliteContractVersion-Attribut dazu verwenden, das Aktualisieren der Hauptassembly zuzulassen, ohne gleichzeitig die Satellitenassemblys zu aktualisieren. Weitere Informationen finden Sie in der Beschreibung der ResourceManager-Klasse in der Microsoft .NET Framework, Version 2.0 SDK-Dokumentation.

Installationsverzeichnis: drive:\Programme\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\HelloWorldReady\

Szenario

Jane ist eine Entwicklerin für Adventure Works Cycles. Sie muss über Grundkenntnisse des Verwendens gespeicherter Prozedur der CLR-Integration verfügen. Sie muss außerdem verstanden haben, wie sie ihre gespeicherten Prozedur der CLR-Integration mithilfe von Prozeduren (die von ihrem Team verwendete Technik) "world-ready" machen kann.

Sprachen

Transact-SQL, Visual C# und Visual Basic.

Features

Das Hello World Ready-Beispiel verwendet die folgenden Features von SQL Server.

Anwendungsbereich	Features
Gesamt	CLR, Metadaten
Lokalisierung	Ressourcen

Voraussetzungen

Stellen Sie vor dem Ausführen dieses 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.

So erstellen Sie das Hello World Ready-Beispiel

Kompilieren Sie das Beispiel mithilfe von Visual Studio 2005 und der bereitgestellten Visual Studio-Projektmappe oder mithilfe von Microsoft MSBuild, das im Lieferumfang von .NET Framework SDK 2.0 enthalten ist. Führen Sie an einer SDK-Eingabeaufforderung einen Befehl aus, der dem folgenden ähnelt:

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ HelloWorld.sln
Kompilieren Sie die Satellitenassemblys, indem Sie die bereitgestellte Datei build.cmd im Ressourcenverzeichnis an der Eingabeaufforderung von .NET Framework oder Visual Studio ausführen. Diese Datei ruft resgen auf. Dieses Programm ist Bestandteil von Visual Studio oder dem .NET Framework SDK.
Stellen Sie sicher, dass die AdventureWorks-Datenbank installiert ist.
Wenn Sie die Beispiele für SQL Server-Datenbankmodul nicht im Standardspeicherort installiert haben, ändern Sie den CREATE ASSEMBLY-Abschnitt des Skripts in Scripts\InstallCS.sql und Scripts\InstallVB.sql, um auf den Speicherort zu verweisen, in dem die Beispiele installiert wurden.
Wenn Sie keine Administratorrechte für die von Ihnen verwendete SQL Server-Instanz besitzen, müssen Sie sich von einem Administrator die CreateAssembly-Berechtigung erteilen lassen, um die Installation ausführen zu können.
Öffnen Sie die Datei scripts\installCS.sql bzw. scripts\installVB.sql (je nachdem, ob Sie das Visual C#-Projekt oder das Visual Basic-Projekt kompiliert haben) in Microsoft SQL Server Management Studio. Führen Sie das in der Datei enthaltene Skript aus, oder führen Sie einen ähnlichen Befehl wie den folgenden an der Eingabeaufforderung aus:

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

Ausführen des Beispiels

So führen Sie das Hello World Ready-Beispiel aus

Öffnen Sie die Datei scripts\test.sql in Management Studio, und führen Sie das in der Datei enthaltene Skript aus. Führen Sie alternativ den folgenden Befehl an der Eingabeaufforderung aus:

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

Entfernen des Beispiels

So entfernen Sie das Hello World Ready-Beispiel

Öffnen Sie die Datei scripts\cleanup.sql in Management Studio, und führen Sie das in der Datei enthaltene Skript aus. Führen Sie alternativ den folgenden Befehl an der Eingabeaufforderung aus:

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

Kommentar

CLR für SQL Server 2005 oder SQL Server Express muss aktiviert sein, damit dieses Beispiel ordnungsgemäß ausgeführt werden kann.

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.

Siehe auch

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

Freigeben über