Beispiel für benutzerdefinierten Datentyp (UDT)

Aktualisiert: 05. Dezember 2005

Das UserDefinedDataType-Beispiel veranschaulicht das Erstellen und Verwenden eines einfachen benutzerdefinierten Datentyps sowohl aus Transact-SQL als auch aus einer Clientanwendung heraus, von der System.Data.SqlClient verwendet wird.

Das standardmäßige Installationslaufwerk lautet drive:\Programme\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\UserDefinedDataType.

Szenario

Ein Entwickler möchte komplexe Zahlen darstellen, permanent speichern und bearbeiten.

Sprachen

Transact-SQL, Visual C# und Visual Basic.

Features

Das UserDefinedDataType-Beispiel verwendet die folgenden SQL Server 2005-Features:

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). SQL Server Express erhalten Sie kostenlos auf der SQL Server 2005 Express Edition Dokumentation und Beispiele-Website.
• 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

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 dieses Beispiel zu erstellen, gehen Sie wie folgt vor:

Beispielerstellung

1. 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 der Eingabeaufforderung einen Befehl aus, der dem folgenden ähnelt:

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

2. Stellen Sie sicher, dass die AdventureWorks-Datenbank installiert ist, oder erstellen Sie (falls erforderlich) die Datenbank, in der Sie die Beispiele installieren möchten.

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

   Diese Datei enthält das Skript für die Installation und Registrierung des SQL CLR UDT-Beispiels in SQL Server.

Ausführen des Beispiels

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

Beispielausführung

1. Öffnen Sie die Datei scripts\test.sql in SQL Server 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

   Dieses Skript ruft die SQL CLR UDT-Beispielobjekte von Transact-SQL aus auf.

2. Führen Sie clientsample.exe aus, und geben Sie dabei an der Eingabeaufforderung den Namen der Datenbank an, in der das Beispiel des benutzerdefinierten Datentyps installiert wurde. Diese einfache Konsolenanwendung ruft das Beispiel des benutzerdefinierten Datentyps mithilfe von System.Data.SqlClient auf.

Entfernen des Beispiels

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

Beispielentfernung

1. Öffnen Sie die Datei scripts\cleanup.sql in SQL Server 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

   Dieses Skript entfernt das UDT-Beispiel.

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

Konzepte

Beispiele für die CLR-Programmierbarkeit

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf