Erstellen eines Beispiels für einen benutzerdefinierten Inkrementtask

Aktualisiert: 05. Dezember 2005

Das Beispiel für einen Inkrementtask demonstriert das programmgesteuerte Erstellen benutzerdefinierter Tasks und der mit ihnen verbundenen Benutzeroberflächen. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt. Das Codebeispiel implementiert die folgende Funktionalität:

• Außerkraftsetzen der Microsoft.SqlServer.Dts.Runtime.Task-Basisklasse.
• Überprüfung
• Ausführung
• Beibehaltungsunterstützung
• Haltepunktunterstützung
• Benutzerdefinierte Ereignisse

Dieses spezielle Codebeispiel tritt während der Ausführung in eine Schleife ein. Bei dieser Schleife wird für jeden Durchlauf eine private ganzzahlige Variable inkrementiert. Die Verarbeitung in der Schleife wird von den Eigenschaften InitialValue, IncrementValue und LoopCount kontrolliert. Diese Eigenschaften werden mithilfe der benutzerdefinierten Benutzeroberfläche festgelegt, die vom Task implementiert wird. Die benutzerdefinierten Haltepunkte OnBeforeIncrement und OnAfterIncrement sowie deren Ereignisse werden vor und nach dem Inkrementieren der Variablen ausgegeben. Die Eigenschaft ExecutionResult enthält den Wert der internen inkrementierten Variablen, der sich am Ende der Taskausführung ergibt.

Wichtig:
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

Überprüfen Sie vor dem Ausführen dieses Codebeispiels, ob die folgenden Bedingungen erfüllt sind:

• Das Beispielpaket und die zugehörigen Beispieldaten müssen zuerst auf der lokalen Festplatte installiert werden. Weitere Informationen finden Sie im Thema zum Installieren und Kompilieren von Integration Services-Programmierungsbeispielen in der Onlinedokumentation.
• 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\Control Flow\IncrementTask 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 noch keine Schlüsseldatei mit starkem Namen im Ordner Samples generiert haben, erstellen Sie diese Datei mithilfe des folgenden Verfahrens. Die Beispielprojekte sind auf der Registerkarte Signierung des Dialogfeldes Projekteigenschaften so konfiguriert, dass Assemblys zum Zeitpunkt der Erstellung mit dieser Schlüsseldatei signiert werden.

So generieren Sie eine Schlüsseldatei mit starkem Namen

1. Klicken Sie zum Öffnen einer Microsoft Visual Studio 2005-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, zeigen Sie 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, zeigen Sie 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. Die Schlüsseldatei, die Sie in diesem Ordner erstellen, wird von allen Microsoft SQL Server 2005-Codebeispielen 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 bei der Installation der Standardspeicherort verwendet wurde, befinden sich die Beispiele im Ordner <system_drive>:\Programme\Microsoft SQL Server\90\Samples.

3. Führen Sie an der Eingabeaufforderung den folgenden Befehl aus, um die Schlüsseldatei zu generieren:

   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.

4. Sie benötigen das öffentliche Schlüsseltoken aus der Schlüsseldatei in einem der nachfolgenden Schritte. Um das öffentliche Schlüsseltoken zu erhalten, extrahieren Sie zuerst den öffentlichen Schlüssel aus der Schlüsseldatei, indem Sie an der Eingabeaufforderung den folgenden Befehl ausführen:

   sn -p SampleKey.snk SampleKeyPublic.snk

5. Zeigen Sie das öffentliche Schlüsseltoken an, indem Sie an der Eingabeaufforderung den folgenden Befehl ausführen:

   sn -t SampleKeyPublic.snk

6. Kopieren Sie das öffentliche Schlüsseltoken in die Zwischenablage, oder speichern Sie es für eine spätere Verwendung.

So erstellen Sie das Beispiel

1. Öffnen Sie Microsoft Visual Studio 2005.

2. Klicken Sie im Menü Datei auf Öffnen, klicken Sie auf Projekt, und öffnen Sie aus dem Verzeichnis mit den gewünschten Beispielen (CS für C#-Beispiele oder VB für Visual Basic-Beispiele) die Datei IncrementTask.sln.

3. Wählen Sie im Projektmappen-Explorer den IncrementTask.cs- oder IncrementTask.vb-Code aus.

4. Suchen Sie im Code nach dem DtsTask-Attribut. Ersetzen Sie in dieser Codezeile in IncrementTask.cs den vorhandenen Wert des öffentlichen Schlüsseltokens in der Attributeigenschaft UITypeName. Der alphanumerische Wert nach "PublicKeyToken =" sollte durch den im vorherigen Schritt angezeigten Wert ersetzt werden.

5. Klicken Sie im Menü Erstellen auf IncrementTask erstellen, um die DLL-Datei für 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 aus, um die Komponente einem Ablaufsteuerungstask in Business Intelligence Development Studio hinzuzufügen.

So installieren Sie die Komponente im globalen Assemblycache durch Drag und Drop der Assembly

1. Kopieren Sie die Assembly (IncrementTaskCS.dll oder IncrementTaskVB.dll) in den Ordner, der sich unter %system%\Programme\Microsoft Sql Server\90\DTS\Tasks befindet.

2. Öffnen Sie in einem zweiten Fenster das Verzeichnis für den globalen Assemblycache unter %system%\assembly. Auf den meisten Computern ist dies C:\Windows\assembly.

3. Wählen Sie die Assembly im ersten Fenster aus, und ziehen Sie sie anschließend in das Fenster, das den Ordner assembly enthält.

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

1. Öffnen Sie ein Eingabeaufforderungsfenster.

2. Geben Sie den folgenden Befehl ein, um die C#-Version der Komponente und die Benutzeroberfläche im globalen Assemblycache zu installieren:

   gacutil.exe -iF "``C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\IncrementTask Sample\CS\bin\Debug\IncrementTaskCS.dll"

3. Geben Sie den folgenden Befehl ein, um die Visual Basic-Version der Komponente und die Benutzeroberfläche im globalen Assemblycache zu installieren:

   gacutil.exe -iF "``C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\IncrementTask Sample\VB\bin\Debug\IncrementTaskVB.dll"

Hinweis   Zwecks Vereinfachung wurde die Benutzeroberfläche für dieses Beispiel im gleichen Projekt abgelegt wie der Taskcode. Somit muss lediglich die DLL in das Assemblyverzeichnis kopiert werden. Falls Sie beabsichtigen, die Benutzeroberfläche für ein anderes Projekt zu codieren, müssen Sie neben der DLL mit dem Code auch die DLL mit der Benutzeroberfläche in den globalen Assemblycache kopieren. Nur der Code muss in ein bestimmtes Verzeichnis kompiliert werden.

Testen des Beispiels

Sie können den Beispieltask im SSIS-Designer testen, indem Sie die folgenden Schritte ausführen.

So verwenden Sie das Beispiel in Business Intelligence Development Studio

1. Öffnen Sie Business Intelligence Development Studio.

2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

3. Klicken Sie im Dialogfeld Neues Projekt unter Projekttypen auf Business Intelligence-Projekte, und klicken Sie im rechten Bereich auf Integration Services-Projekt.

4. Geben Sie IncrementTask in das Feld Name als Namen für das neue Projekt ein.

5. Wählen Sie im Feld Speicherort den gewünschten Speicherort für die Datei aus. Klicken Sie auf OK.

6. Doppelklicken Sie im Dialogfeld Projektmappen-Explorer auf Package.dtsx.

7. Klicken Sie in der Toolbox Ablaufsteuerungselemente mit der rechten Maustaste auf eine beliebige Stelle in dem Bereich, in dem Ablaufsteuerungselemente aufgelistet sind. Klicken Sie auf Elemente auswählen.

8. Klicken Sie auf die Registerkarte SSIS-Ablaufsteuerungselemente. Führen Sie einen Bildlauf nach unten durch, und wählen Sie das Element IncrementTaskCS bzw. IncrementTaskVB aus. Klicken Sie auf OK. Der IncrementTask-Task sollte nun in der Toolbox Ablaufsteuerungselemente erscheinen.

9. Fügen Sie IncrementTask der Ablaufsteuerungsoberfläche des Pakets hinzu, indem Sie auf den Task doppelklicken oder den Task auf die Ablaufsteuerungsoberfläche ziehen.

10. Sobald der Task auf der Entwurfsoberfläche angezeigt wird, doppelklicken Sie auf den Task, um den Editor zu öffnen. Legen Sie Loop Count auf 5 und Increment Value auf 1 fest.

11. Klicken Sie auf Fertig.

12. Führen Sie das Paket aus.

13. Zeigen Sie nach Fertigstellung des Pakets die Registerkarte Ausführungsergebnisse im Designer an.

Änderungsverlauf