Readme_Zeichenfolgendarstellung mit ergänzenden Zeichen (Beispiel)

Dieses Beispiel funktioniert nur mit SQL Server 2005 und SQL Server 2008. In einer SQL Server-Version vor SQL Server 2005 kann das Beispiel nicht ausgeführt werden.

Das StringManipulate-Beispiel für Microsoft SQL Server veranschaulicht Zeichenfolgenbearbeitungen mit ergänzenden Zeichen. Dieses Beispiel veranschaulicht die Implementierung von fünf Transact-SQL-Zeichenfolgenfunktionen, die dieselben Bearbeitungsfunktionen für Zeichenfolgen bereitstellen wie integrierte Funktionen, jedoch zusätzliche Funktionen für ergänzende Zeichen bieten, um sowohl Unicode- als auch Sonderzeichenfolgen bearbeiten zu können. Die fünf Funktionen sind len_s(), left_s(), right_s(), sub_s() und replace_s(). Sie entsprechen den integrierten Funktionen LEN(), LEFT(), RIGHT(), SUBSTRING() und REPLACE().

Standardspeicherort: **C:\Programme\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\StringManipulate

SQL Server-Beispiele und -Beispieldatenbanken müssen heruntergeladen und installiert werden, bevor Sie sie anzeigen oder mit ihnen arbeiten können. Weitere Informationen finden Sie unter Überlegungen zum Installieren der SQL Server-Beispiele und -Beispieldatenbanken.

Szenario

Ein Entwickler möchte Unicode-Zeichenfolgen, die ergänzende Zeichen enthalten, ordnungsgemäß bearbeiten.

Sprachen

Transact-SQL, Visual C# und Visual Basic.

Features

Das StringManipulate-Beispiel verwendet die folgenden Features von Microsoft SQL Server:

Voraussetzungen

Vor dem Ausführen dieses Beispiels muss die folgende Software installiert werden:

• Microsoft SQL Server oder Microsoft SQL Server Express. SQL Server Express erhalten Sie kostenlos auf der Website mit der Dokumentation und den Beispielen für SQL Server Express.
• Die AdventureWorks-Datenbank, die auf der SQL Server Developer-Website zur Verfügung gestellt wird.
• Die SQL Server Database Engine (Datenbankmodul)-Beispiele, die auf der SQL Server Developer-Website zur Verfügung gestellt werden.
• .NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Das .NET Framework SDK ist kostenlos erhältlich. Siehe Installieren der .NET Framework-Dokumentation.
• Die Schriftart Ext-B muss auf dem Computer installiert sein, damit im Ergebnisfenster von SQL Server Management Studio die richtigen Zeichen angezeigt werden. Zum Ändern der Schriftart im Ergebnisfenster in Management Studio klicken Sie im Menü Extras auf Optionen, erweitern Umgebung und klicken dann auf Schriftarten und Farben. Legen Sie als Schriftart MingLiU_ExtB für Textergebnisse und/oder Rasterergebnisse fest. Management Studio muss geschlossen und erneut geöffnet werden, damit die Änderungen wirksam werden.

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. Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft Visual Studio 2005 und auf Visual Studio Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.

   - Oder -

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

2. Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) vom aktuellen Ordner im Eingabeaufforderungsfenster zum Ordner Samples.

   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 <system_drive>:\Programme\Microsoft SQL Server\100\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 der MSDN-Website.

Führen Sie folgende Aktionen aus, um das Beispiel zu erstellen:

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\ StringManipulate.sln

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

3. Falls Sie die Beispiele für SQL Server Database Engine (Datenbankmodul) nicht im Standardspeicherort installiert haben, ändern Sie den Pfad im CREATE ASSEMBLY-Abschnitt des Skripts in Scripts\InstallCS.sql und Scripts\InstallVB.sql auf den Speicherort, in dem die Beispiele installiert wurden.

4. Ö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 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 CLR-Objekte in SQL Server.

Ausführen des Beispiels

Um das Beispiel auszuführen, ist Folgendes erforderlich:

Beispielausführung

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

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

   Mit diesem Skript wird das Beispiel für die Zeichenfolgendarstellung in Transact-SQL aufgerufen.

Entfernen des Beispiels

Führen Sie folgende Aktionen aus, um das StringManipulate-Beispiel zu entfernen:

Beispielentfernung

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

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

   Mit diesem Skript wird das Beispiel entfernt.

Kommentar

CLR für SQL Server 2008 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.