Excel2 Custom Connection Manager-Beispiel

Artikel
12/15/2008

Neu: 14. April 2006

Mit dem Excel2 Custom Connection Manager-Beispiel wird demonstriert, wie Sie einen benutzerdefinierten Verbindungs-Manager, den Excel2-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.

Der benutzerdefinierte Verbindungs-Manager stellt mithilfe des OleDb-Datenproviders für das .NET Framework und dem Microsoft OLE DB-Anbieter für Jet eine Verbindung mit einer verfügbaren Microsoft Excel-Arbeitsmappe her und gibt ein offenes OleDbConnection-Objekt aus seiner AcquireConnection-Methode zurück. Wenn Sie in einem Paket eine neue Instanz des Excel2-Verbindungs-Managers erstellen, werden Sie über die zugehörige benutzerdefinierte Benutzeroberfläche aufgefordert, den Pfad der Excel-Arbeitsmappe einzugeben. Dieser Verbindungs-Manager stellt außerdem ein Kontrollkästchen zum Angeben des Importmodus bereit. Dadurch wird ein Problem gelöst, das häufig auftritt, wenn in einer Excel-Spalte sowohl Text als auch numerische Daten enthalten sind.

Hinweis:
Das Excel2 Custom Connection Manager-Beispiel kann nicht mit der Excel-Quelle und dem Excel-Ziel verwendet werden. Testen Sie das Beispiel stattdessen mit der DataReader-Quelle und dem DataReader-Ziel.

Das Codebeispiel implementiert die folgende Funktionalität:

Außerkraftsetzen 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 dieses Beispiels.

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\Excel2ConnectionManager Sample

Die C#-Lösung für das Codebeispiel ist im Verzeichnis Excel2ConnMgrCS, und die Visual Basic-Lösung ist im Verzeichnis Excel2ConnMgrVB 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, müssen Sie diese Datei mit dem folgenden Verfahren erstellen. Die Beispielprojekte werden auf der Registerkarte Signierung des Dialogfeldes Projekteigenschaften so konfiguriert, dass die Assemblys bei der Erstellung mit dieser Schlüsseldatei signiert werden.

So erstellen Sie eine Schlüsseldatei mit starkem Namen

Klicken Sie zum Öffnen einer Microsoft Visual Studio 2005-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, Microsoft Visual Studio 2005, 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, auf Microsoft .NET Framework SDK v2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

Verwenden Sie an der Eingabeaufforderung den Befehl CD (Change Directory oder Verzeichnis wechseln), um den aktuellen Ordner des Eingabeaufforderungsfensters in den Ordner Samples zu ändern. Die Schlüsseldatei, die Sie in diesem Ordner erstellen, wird von allen SQL Server 2005-Codebeispielen verwendet.

Hinweis:
Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server 2005 und Documentation and Tutorials, und klicken Sie dann auf Samples Directory, um den Ordner zu bestimmen, in dem die Beispiele gespeichert sind. Wenn für die Installation das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Ordner <system_drive>:\Programme\Microsoft SQL Server\90\Samples.

Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Erstellen 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" im .NET Development Center auf MSDN.
Sie benötigen das öffentliche Schlüsseltoken aus der Schlüsseldatei in einem späteren 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 für eine spätere Verwendung.

Wichtig:
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" im .NET Development Center auf 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 dann Excel2ConnMgrVB.sln oder Excel2ConnMgrCS.sln.
Wählen Sie im Projektmappen-Explorer das Projekt Excel2ConnMgrVB or Excel2ConnMgrCS aus.
Suchen Sie in der Datei Excel2ConnMgrCS.cs bzw. Excel2ConnMgrVB.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 in Business Intelligence Development Studio die Komponente als Verbindungs-Manager in einem Paket hinzuzufügen.

So kopieren Sie die Komponente in den Ordner Verbindungen

Öffnen Sie Windows-Explorer bzw.die Anwendung, mit der Sie üblicherweise im Dateisystem arbeiten.
Kopieren Sie die Assemblys (Excel2ConnMgrCS.dll und Excel2ConnMgrUICS.dll bzw. Excel2ConnMgrVB.dll und Excel2ConnMgrUIVB.dll) in den Ordner Verbindungen im Verzeichnis %system%\Programme\Microsoft SQL Server\90\DTS\Connections.

So installieren Sie die Komponente im globalen Assemblycache (GAC) durch Drag und Drop der Assemblys

Öffnen Sie Windows-Explorer bzw.die Anwendung, mit der Sie üblicherweise im Dateisystem arbeiten.
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\Excel2ConnectionManager Sample\CS\Excel2ConnMgrCS\bin\Debug\Excel2ConnMgrCS.dll"
gacutil.exe -iF "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\CS\Excel2ConnMgrUICS\bin\Debug\Excel2ConnMgrUICS.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\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrUIVB.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 EXCEL2 aus. Klicken Sie auf OK.

Bearbeiten Sie den neuen Verbindungs-Manager. Suchen Sie im Excel2-Verbindungs-Manager-Editor nach einer verfügbaren Excel-Arbeitsmappendatei. Geben Sie mithilfe der Kontrollkästchen die Einstellungen für die Header und den Importmodus an.

Hinweis:
Das Excel2 Custom Connection Manager-Beispiel kann nicht mit der Excel-Quelle verwendet werden, die nur die integrierten Excel-Verbindungs-Manager unterstützt. Testen Sie das Beispiel stattdessen mit der DataReader-Quelle.

Freigeben über