Change Case-Komponentenbeispiel

Das Change Case-Komponentenbeispiel stellt eine Transformationskomponente mit synchroner Ausgabe dar. Die Komponente ändert die Groß-/Kleinschreibung eines Zeichens innerhalb einer Zeichenfolge. Dabei wird während des Durchlaufs der Zeilen durch die Komponente ein einzelnes Zeichen in der angegebenen Spalte geändert. Damit Benutzer der Komponente das Zeichen in der Spalte sowie den Typ der vorzunehmenden Konvertierung angeben können, fügt die Komponente pro Spalte, die für die Komponente ausgewählt wurde, in der Eingabespalte jeweils zwei benutzerdefinierte Eigenschaften hinzu. Diese Eigenschaften geben an, welches Zeichen in der Spalte geändert werden und ob die Änderung in Großschreibung oder Kleinschreibung erfolgen soll.

Dieses Beispiel zeigt auch, wie eine Fehlerausgabe für eine Datenflusskomponente implementiert wird. Wenn der Benutzer angegeben hat, dass Zeilen in die Fehlerausgabe umgeleitet werden sollen, leitet die Komponente immer dann eine Zeile an ihre Fehlerausgabe, wenn der Index des zu ändernden Zeichens die Länge der Zeichenfolge überschreitet. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt.

Wichtig:

Die Codebeispiele der Datenflussprogrammierung von Integration Services dienen der Veranschaulichung der Kernfunktionalität, deren Implementierung Voraussetzung für das Erstellen einer benutzerdefinierten Datenflusskomponente ist. Die Beispiele enthalten keine vollständige Unterstützung für die Anpassung im erweiterten Editor. So können Sie beispielsweise mit dem erweiterten Editor keine Eingaben oder Ausgaben hinzufügen bzw. entfernen und auch keine Spalten konfigurieren. 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.

Ausführen des Beispiels

Wenn Ihnen bereits bekannt ist, wie Codebeispiele gefunden, erstellt und installiert werden, können Sie direkt zum Abschnitt Testen des Beispiels wechseln. Dort erhalten Sie Informationen zum Konfigurieren und Ausführen des Codebeispiels.

Voraussetzungen

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

• Microsoft Visual Studio 2005
• Microsoft SQL Server 2005 Integration Services

Speicherort

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

C:\Programme\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\ChangeCase Component Sample

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

Weitere Informationen zu dem zwei Schritte umfassenden Prozess der Installation von Beispielen finden Sie unter Installieren von Beispielen. Wenn Sie die aktuelle Version der Beispiele erhalten möchten, einschließlich neuer Beispiele, die nach der ursprünglichen Version von SQL Server 2005 veröffentlicht wurden, finden Sie entsprechende Informationen unter SQL Server 2005 Samples and Sample Databases (April 2006) (in Englisch).

Erstellen des Beispiels

Wenn Sie nicht bereits eine Schlüsseldatei mit starkem Namen im Ordner Samples generiert haben, gehen Sie wie folgt vor, um diese Schlüsseldatei zu generieren. Die Beispielprojekte sind so konfiguriert, dass Assemblys bei der Erstellung mit dieser Schlüsseldatei signiert werden. Sie können die Signierungseigenschaften auf der Registerkarte Signierung des Dialogfeldes Projekteigenschaften anzeigen.

So generieren Sie eine Schlüsseldatei mit starkem Namen

1. Klicken Sie zum Öffnen einer Microsoft Visual Studio-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, anschließend auf Microsoft Visual Studio 2005 und auf Visual Studio Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.

   - Oder -

   Klicken Sie zum Öffnen einer Microsoft .NET Framework-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, anschließend auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

2. Verwenden Sie an der Eingabeaufforderung den Befehl zum Ändern des Verzeichnisses (CD), um den aktuellen Ordner des Eingabeaufforderungsfensters in den Ordner Samples zu ändern. Die Schlüsseldatei, die Sie in diesem Ordner erstellen, wird für alle SQL Server 2005-Codebeispiele verwendet.

   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: <Systemlaufwerk>:\Programme\Microsoft SQL Server\90\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 MSDN.

So erstellen Sie das Beispiel in Microsoft Visual Studio 2005

1. Klicken Sie im Menü Datei auf Öffnen und auf Projekt, und öffnen Sie dann die Datei ChangeCase.sln in der gewünschten Programmiersprache.

2. Klicken Sie im Menü Erstellen auf ChangeCase erstellen, um das Projekt zu erstellen.

Installieren des Beispiels

Das Beispiel liegt sowohl in einer Visual Basic- als auch in einer C#-Version vor. Um die Assemblys der jeweiligen Version des Beispiels zu unterscheiden, wird CS oder VB an den Namen der Ausgabeassembly angefügt. Führen Sie nach dem erfolgreichen Erstellen der Komponente die folgenden Schritte durch, um die Komponente einem Datenflusstask in Business Intelligence Development Studio hinzuzufügen.

So kopieren Sie die Komponente in den Ordner PipelineComponents

1. Öffnen Sie Windows-Explorer oder Ihre bevorzugte Anwendung zum Arbeiten im Dateisystem.

2. Kopieren Sie die Assembly (ChangeCaseCS.dll oder ChangeCaseVB.dll) in den Ordner PipelineComponents, der sich unter %system%\Programme\Microsoft Sql Server\90\DTS befindet.

So installieren Sie die Komponente im globalen Assemblycache (GAC) durch Ziehen der Assembly mit der Maus

1. Öffnen Sie Windows-Explorer oder Ihre bevorzugte Anwendung zum Arbeiten im Dateisystem.

2. Ziehen Sie die Assembly aus dem Ordner PipelineComponents in den Ordner mit dem globalen Assemblycache (GAC) unter %system%\assembly.

So installieren Sie die Komponente im globalen Assemblycache (GAC) mithilfe von gacutil.exe

1. Öffnen Sie ein Eingabeaufforderungsfenster.

2. Geben Sie den folgenden Befehl ein, um gacutil.exe auszuführen und die C#-Version der Komponente im GAC zu installieren:

   gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\ ChangeCaseCS.dll "

   - or -

   Geben Sie den folgenden Befehl ein, um gacutil.exe auszuführen und die Visual Basic-Version der Komponente im GAC zu installieren:

   gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\ ChangeCaseVB.dll "

So fügen Sie die Komponente zur Toolbox hinzu

1. Öffnen Sie Business Intelligence Development Studio.

2. Klicken Sie mit der rechten Maustaste auf die Toolbox, und klicken Sie dann auf Elemente auswählen.

3. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte SSIS-Datenflusselemente.

4. Klicken Sie auf das Kontrollkästchen neben Ihrer Komponente, und klicken Sie dann auf OK.

   Hinweis:
   Wenn die Komponente nicht in der Liste angezeigt wird, können Sie auf Durchsuchen klicken, um die Komponente selbst zu suchen. In diesem Fall ist sie jedoch möglicherweise nicht ordnungsgemäß installiert.

Nachdem Sie diese Schritte ausgeführt haben, erscheint die Komponente im Abschnitt Datenflusstransformationen der Toolbox und kann der Datenflussaufgabe im Designer hinzugefügt werden.

Testen des Beispiels

Nachdem Sie die Komponente einem Datenflusstask in einem Paket hinzugefügt und eine Verbindung mit einer anderen Komponente hergestellt haben, die Zeilen bereitstellt, können Sie sie im SSIS-Designer wie folgt konfigurieren:

So konfigurieren Sie die Beispielkomponente in einem Paket

1. Klicken Sie auf die Registerkarte Eingabespalten des erweiterten Editors, und wählen Sie Spalten aus, die von der Komponente geändert werden sollen. Der Verwendungstyp der ausgewählten Spalten muss auf Lesen/Schreiben festgelegt sein, da die Komponente bei der Verarbeitung der eingehenden Datenzeilen die vorhandenen Spaltenwerte ändert.

2. Klicken Sie auf die Registerkarte Spalteneigenschaften des erweiterten Editors, um den nullbasierten Zeichenindex anzugeben, der in jeder zu ändernden Eingabespalte geändert werden soll. Geben Sie außerdem an, ob die Änderung des Zeichens in diesem Index in Großschreibung (0) oder Kleinschreibung (1) erfolgt.