UDT Utilities

Aktualisiert: 05. Dezember 2005

Das UDTUtilities-Beispiel enthält eine Reihe von Dienstprogrammfunktionen. Hierzu gehören u. a. Funktionen zum Verfügbarmachen von Assemblymetadaten für Transact-SQL, Beispiele für Streaming-Tabellenwertfunktionen (Table-Valued Functions, TVFs), mit denen die Typen in einer Assembly als Tabelle zurückgegeben werden können, sowie Funktionen zum Zurückgeben von Feldern, Methoden und Eigenschaften in einem benutzerdefinierten Datentyp. Zu den veranschaulichten Technologien zählen Streaming-Tabellenwertfunktionen, .NET Framework-Reflektions-APIs und das Aufrufen von Tabellenwertfunktionen aus Transact-SQL.

Beachten Sie, dass beim Kompilieren von CLR-Integrationsbeispielen (Common Language Runtime) der Pfad der Version des mit SQL Server 2005 verteilten Microsoft .NET Framework-Compilers das erste Framework-Verzeichnis sein muss, das in der PATH-Umgebungsvariablen angegeben ist. Der Speicherort des in SQL Server 2005 enthaltenen Compilers ist entweder drive:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx oder drive:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, wobei drive für das Installationslaufwerk und xxxxx für die in Ihrer Kopie von SQL Server 2005 enthaltene .NET Framework-Version steht.

Das standardmäßige Installationsverzeichnis ist drive:\Programme\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\UDTUtilities.

Szenario

Ein Entwickler möchte auf Metadaten zu CLR-basierten benutzerdefinierten Datentypen zugreifen.

Sprachen

Transact-SQL, Visual C# und Visual Basic.

Features

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

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

Wenn Sie die Schlüsseldatei mit starkem Namen, ExternalSampleKey.snk, nicht bereits erstellt haben, generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen.

So generieren Sie eine Schlüsseldatei mit starkem Namen

1. Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Zeigen Sie im Menü Start auf Alle Programme, zeigen Sie auf Microsoft Visual Studio 2005 und anschließend auf Visual Studio-Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.

   - Oder -

   Öffnen Sie ein Microsoft .NET Framework-Eingabeaufforderungsfenster. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

2. Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Change Directory) vom aktuellen Ordner des Eingabeaufforderungsfensters zum Ordner Samples.

   Hinweis:

   Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server 2005 und auf Documentation and Tutorials, und klicken Sie dann auf Samples Directory, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardinstallationsverzeichnis verwendet wurde, sind die Beispieldateien am folgenden Speicherort installiert: <system_drive>:\Programme\Microsoft SQL Server\90\Samples\.

3. Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:

   sn -k ExternalSampleKey.snk

   Wichtig:
   Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Strong Names and Security in the .NET Framework" (in Englisch) im .NET Development Center auf MSDN.

Um das 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\UDTUtilities.sln

2. Stellen Sie sicher, dass die AdventureWorks-Datenbank installiert ist, oder erstellen Sie (bei Bedarf) 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 Skripts zum Installieren und Registrieren der Dienstprogrammbeispiele in SQL Server.

Ausführen des Beispiels

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

Beispielausführung

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

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

   Dieses Skript ruft die Beispielobjekte des Beispieldienstprogramms von Transact-SQL aus auf.

Entfernen des Beispiels

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

Beispielentfernung

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

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

   Dieses Skript entfernt das 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