Readme_UtilityConversion

Aktualisiert: 05. Dezember 2005

Dieses Beispiel veranschaulicht Techniken zum Implementieren von Assemblyfunktionen (SQLCLR) in Datenbankanwendungen. Mithilfe von SQL Server CLR-Funktionen (Common Language Runtime) von Microsoft SQL Server können Benutzer mit dieser Anwendung CLR-Assemblycode in SQL Server ausführen. Dieses Beispiel stellt Beispielcode für verschiedene Datentypkonvertierungen bereit.

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.

Anforderungen

Für dieses Beispiel müssen die folgenden Komponenten installiert sein.

• .NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Das .NET Framework SDK ist kostenlos erhältlich. Siehe Installieren des .NET Framework SDK.
• Microsoft SQL Server 2005 Integration Services.
• Das Beispielpaket und die verwendeten Datendateien müssen auf der lokalen Festplatte installiert sein.
• Die AdventureWorks-OLTP-Datenbank muss installiert sein.
• Die AdventureWorks-Datenbank muss angefügt sein.
• Sie müssen über Administratorberechtigungen für die AdventureWorks-Datenbank verfügen.
• Dieses Beispiel wird von LoadRegAssembly.exe des LoadRegAssembly-Projekts verwendet.

Weitere Informationen zum Installieren von Beispielen finden Sie unter "Installieren von Integration Services-Beispielpaketen" in der SQL Server-Onlinedokumentation.

Speicherort

Wenn das Codebeispiel am Standardspeicherort installiert wurde, ist das Beispiel in folgendem Verzeichnis gespeichert:

C:\Programme\Microsoft SQL Server\90\Samples\Engine\Programmability\SMO\UtilityConversion

Die C#-Lösung für das Codebeispiel ist im CS-Verzeichnis und die Visual Basic-Lösung im VB-Verzeichnis gespeichert.

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.

Erstellen und Verwenden des Beispiels mithilfe des Befehlszeilencompilers

1. Öffnen Sie ein .NET Framework- oder Microsoft Visual Studio 2005-Eingabeaufforderungsfenster. Wechseln Sie mithilfe des Befehls CD (Change Directory) vom aktuellen Verzeichnis des Eingabeaufforderungsfensters zu dem Projektmappenverzeichnis, in dem Sie arbeiten möchten.

2. Geben Sie den folgenden Befehl ein, um die C#- oder die Visual Basic-Version des Beispiels zu erstellen:

   for /r %f in (*.sln) do msbuild.exe "%f"

Erstellen und Verwenden des Beispiels in Microsoft Visual Studio 2005 (optional)

1. Klicken Sie im Menü Datei von Microsoft Visual Studio 2005 auf Öffnen und auf Projekt, und öffnen Sie dann in dem Projektmappenverzeichnis, in dem Sie arbeiten möchten, die Datei UtilityConversion.sln.

2. Drücken Sie F5, oder klicken Sie im Menü Debuggen auf Starten, um das Projekt zu kompilieren und auszuführen.

Änderungsverlauf