Sql Server Custom Connection Manager-Beispiel

Artikel
12/15/2008

Aktualisiert: 14. April 2006

Mit dem SQL Server Custom Connection Manager-Beispiel wird demonstriert, wie Sie einen benutzerdefinierten Verbindungs-Manager, den SQL-Verbindungs-Manager, und die zugehörige Benutzeroberfläche erstellen. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt.

Weitere Informationen zum Erstellen eines benutzerdefinierten Verbindungs-Managers finden Sie unter Creating a Custom Connection Manager. Allgemeine Informationen zum Verwenden von Verbindungs-Managern in Integration Services finden Sie unter SQL Server Integration Services-Verbindungen und Verbindungs-Manager.

Dieser benutzerdefinierte Verbindungs-Manager stellt mithilfe des .NET Framework-Datenproviders für SqlClient eine Verbindung mit einer verfügbaren Instanz von Microsoft SQL Server her und gibt ein offenes SqlConnection-Objekt aus seiner AcquireConnection-Methode zurück. Wenn Sie eine neue Instanz des Sql-Verbindungs-Managers in einem Paket erstellen, werden Sie von dessen benutzerdefinierter Benutzeroberfläche aufgefordert, den Namen des Servers und den einer Datenbank einzugeben. Das Beispiel stellt nur eine Verbindung zu einer Standardinstanz von SQL Server her und verwendet nur Windows-Authentifizierung.

Das Codebeispiel implementiert die folgende Funktionalität:

Überschreiben der ConnectionManagerBase-Klasse.
Beibehaltungsunterstützung

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

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\Control Flow\SqlConnectionManager Sample

Die C#-Lösung für das Codebeispiel ist im Verzeichnis SqlConnMgrCS, und die Visual Basic-Lösung ist im Verzeichnis SqlConnMgrVB 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, generieren Sie diese Schlüsseldatei mithilfe des folgenden Verfahrens. Die Beispielprojekte werden auf der Registerkarte "Signierung" des Dialogfeldes "Projekteigenschaften" so konfiguriert, dass Assemblys beim Erstellen mit dieser Schlüsseldatei signiert werden.

So generieren Sie eine Schlüsseldatei mit starkem Namen

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, um eine Microsoft Visual Studio 2005-Eingabeaufforderung zu öffnen.

- Oder -

Klicken Sie zum Öffnen einer Microsoft .NET Framework-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, auf Microsoft .NET Framework SDK v2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

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 von Ihnen in diesem Ordner erstellte Schlüsseldatei wird von allen 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 das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <system_drive>:\Programme\Microsoft SQL Server\90\Samples.

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 von MSDN.
Sie benötigen das öffentliche Schlüsseltoken aus der Schlüsseldatei in einem nachfolgenden Schritt. Um das öffentliche Schlüsseltoken abzurufen, extrahieren Sie zunächst den öffentlichen Schlüssel aus der Schlüsseldatei in eine neue Datei, indem Sie den folgenden Befehl an der Eingabeaufforderung ausführen:
```
sn -p SampleKey.snk SampleKeyPublic.snk
```
Zeigen Sie nun das öffentliche Schlüsseltoken aus der neuen Datei an, indem Sie den folgenden Befehl an der Eingabeaufforderung ausführen:
```
sn -t SampleKeyPublic.snk
```
Kopieren Sie das öffentliche Schlüsseltoken in die Zwischenablage, oder speichern Sie es zur späteren Verwendung.

Wichtig:
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter .NET-Entwicklung von MSDN.

So erstellen Sie das Beispiel in Microsoft Visual Studio 2005

Klicken Sie im Menü Datei auf Öffnen, klicken Sie auf Projekt, und öffnen Sie die Projektmappendatei SqlConnMgrVB.sln oder SqlConnMgrCS.sln.
Wählen Sie im Projektmappen-Explorer das Projekt SqlConnMgrVB oder SqlConnMgrCS aus.
Suchen Sie in der Datei SqlConnMgrCS.cs bzw. SqlConnMgrVB.vb das DtsConnection-Attribut vor der Klassendeklaration, und ersetzen Sie den alphanumerischen Wert des öffentlichen Schlüsseltokens in der UITypeName-Eigenschaft des Attributs durch das öffentliche Schlüsseltoken, das Sie zuvor aus der Schlüsseldatei abgerufen haben.
Klicken Sie im Menü Erstellen auf Projektmappe 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 als Verbindungs-Manager in einem Paket in Business Intelligence Development Studio hinzuzufügen.

So kopieren Sie die Komponente in den Ordner Connections

Öffnen Sie Windows-Explorer oder Ihre zum Arbeiten im Dateisystem bevorzugte Anwendung.
Kopieren Sie die Assemblys (SqlConnMgrCS.dll und SqlConnMgrUICS.dll bzw. SqlConnMgrVB.dll und SqlConnMgrUIVB.dll) in den Ordner Verbindungen im Verzeichnis %system%\Programme\Microsoft SQL Server\90\DTS.

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

Öffnen Sie Windows-Explorer oder Ihre zum Arbeiten im Dateisystem bevorzugte Anwendung.
Ziehen Sie die Assemblys aus dem Ordner Connections in den Ordner mit dem globalen Assemblycache (GAC) unter %system%\assembly.

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

Öffnen Sie ein Eingabeaufforderungsfenster.

Geben Sie die folgenden Befehle ein, um die C#-Version der Komponente und die Benutzeroberfläche im GAC zu installieren:

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

- Oder -

Geben Sie die folgenden Befehle ein, um die Visual Basic-Version der Komponente und die Benutzeroberfläche im GAC zu installieren:

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

Testen des Beispiels

Nun können Sie den benutzerdefinierten Verbindungs-Manager in einem Paket testen.

So verwenden Sie den Beispiel-Verbindungs-Manager in einem Paket

Klicken Sie mit der rechten Maustaste im Verbindungs-Manager-Bereich des SSIS-Designers, wählen Sie Neue Verbindung aus, und wählen Sie in der Liste der verfügbaren Verbindungstypen den Eintrag SQL aus. Klicken Sie auf OK.
Bearbeiten Sie den neuen Verbindungs-Manager. Geben Sie im Sql-Verbindungs-Manager-Editor den Namen einer verfügbaren Standardinstanz des SQL Server-Datenbankmoduls und einer verfügbaren Datenbank ein.

Änderungsverlauf

Version	Verlauf
14. April 2006	Geänderter Inhalt: Datei- und Ordnernamen wurden korrigiert.

Freigeben über