Образец пользовательского диспетчера соединений с Excel2

Статья
12/15/2008

Добавления: 14 апреля 2006 г.

Образец пользовательского диспетчера соединений с Excel2 демонстрирует, каким образом можно создать пользовательский диспетчер соединений, диспетчер соединений с Excel2 и связанный с ним пользовательский интерфейс. Этот образец не поддерживается в операционных системах на платформе Itanium.

Дополнительные сведения о создании пользовательского диспетчера соединений см. в разделе Creating a Custom Connection Manager. Общие сведения об использовании диспетчеров соединений в службах Integration Services см. в разделах Соединения служб Integration Services и Диспетчеры соединений.

Пользовательский диспетчер соединений выполняет подключение к доступной книге Microsoft Excel при помощи поставщика данных OleDb .NET Framework и поставщика Microsoft OLE DB для Jet и возвращает открытый объект OleDbConnection в своем методе AcquireConnection. При создании в пакете нового экземпляра диспетчера соединений с Excel2 его пользовательский интерфейс предлагает задать путь к книге Excel. Он предлагает также установить флажок, определяющий режим импорта. Это позволяет решить часто возникающую проблему, когда столбец Excel содержит вместе с числовыми данными текст.

Примечание.
Пользовательский пример диспетчера соединений с Excel2 не может использоваться с источником и назначением Excel. Вместо этого проверьте его с источником и назначением DataReader.

Образец кода реализует следующую функциональность.

Переопределение класса ConnectionManagerBase.
Поддержка сохраняемости.

Важно!
Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Корпорация Майкрософт не предоставляет техническую поддержку для этих образцов.

Выполнение образца

Если вы уже умеете находить, строить и устанавливать программного кода, можно перейти непосредственно к разделу Проверка образца.

Предварительные требования

Для данного образца должны быть установлены следующие компоненты.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Расположение

Если образец кода был установлен в каталог по умолчанию, то он расположен в следующем каталоге.

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\Excel2ConnectionManager Sample

Решение для образца кода на языке C# расположено в каталоге Excel2ConnMgrCS, а решение на языке Visual Basic находится в каталоге Excel2ConnMgrVB.

Сведения о двухэтапном процессе установки образцов см. в разделе Установка образцов. Чтобы получить последнюю версию образцов, включая новые, выпущенные после исходной версии SQL Server 2005, см. веб-страницу «Образцы SQL Server 2005 и образцы баз данных (апрель 2006 г.)».

Построение образца

Если в папке Samples еще не создан файл ключа для строгого имени, создайте его с помощью следующей процедуры. Настройка проектов образцов выполняется на вкладке «Подпись» диалогового окна «Свойства проекта», после чего данный файл ключа используется для подписи сборок в процессе построения.

Создание файла ключа для строгого имени

Откройте командную строку Microsoft Visual Studio 2005: нажмите кнопку «Пуск», а затем последовательно укажите «Все программы», «Microsoft Visual Studio 2005», «Средства Visual Studio» и выберите пункт «Командная строка Visual Studio 2005».

— или —

Для открытия командной строки платформы Microsoft .NET Framework нажмите «Пуск», последовательно укажите «Все программы», «Microsoft .NET Framework SDK v2.0» и выберите пункт «Командная строка пакета SDK».

В командной строке введите команду смены каталога (CD) и перейдите из текущей папки командной строки в папку Samples. Созданный в этой папке файл ключа будет использоваться всеми образцами кода SQL Server 2005.

Примечание.
Чтобы определить каталог, в котором установлены образцы, нажмите кнопку «Пуск», последовательно укажите «Все программы», «Microsoft SQL Server 2005», «Документация и учебные материалы» и выберите пункт «Каталог образцов». Если использовался каталог установки по умолчанию, то образцы находятся в каталоге «<системный_диск>:\Program Files\Microsoft SQL Server\90\Samples».

Чтобы определить каталог, в котором установлены образцы, нажмите кнопку «Пуск», последовательно укажите «Все программы», «Microsoft SQL Server 2005», «Документация и учебные материалы» и выберите пункт «Каталог образцов». Если использовался каталог установки по умолчанию, то образцы находятся в каталоге «<системный_диск>:\Program Files\Microsoft SQL Server\90\Samples».

Для создания файла ключа выполните следующую команду в командной строке:

sn -k SampleKey.snk

Важно!
Дополнительные сведения о паре ключей для строгого имени см. в разделе «Краткие сведения по безопасности: Строгие имена и безопасность на платформе .NET Framework» в центре для разработчиков .NET в MSDN.

Для выполнения следующего шага необходимо извлечь маркер открытого ключа из файла ключа. Чтобы извлечь маркер открытого ключа, необходимо сначала извлечь открытый ключ из файла ключа в новый файл. Для этого в командной строке необходимо выполнить следующую команду:
```
sn -p SampleKey.snk SampleKeyPublic.snk
```
Затем отобразите маркер открытого ключа из нового файла, выполнив в командной строке следующую команду:
```
sn -t SampleKeyPublic.snk
```
Скопируйте маркер открытого ключа в буфер обмена или сохраните его для дальнейшего использования.

Построение образца в среде Microsoft Visual Studio 2005

В меню Файл | Открыть выберите Проект и откройте Excel2ConnMgrVB.sln или Excel2ConnMgrCS.sln.
В обозревателе решений выберите проект Excel2ConnMgrVB или Excel2ConnMgrCS.
Найдите атрибут DtsConnection перед объявлением класса в файле Excel2ConnMgrCS.cs или Excel2ConnMgrVB.vb и замените алфавитно-цифровое значение маркера открытого ключа в свойстве UITypeName атрибута на маркер открытого ключа, полученный ранее из файла ключа.
В меню Построить выберите пункт Построить решение, чтобы выполнить построение решения.

Установка образца

Этот образец предоставлен на языках Visual Basic и C#. Чтобы отличать сборки для каждой версии образца, к имени выходной сборки добавляется CS или VB. После успешного построения компонента выполните следующие шаги, чтобы добавить его в качестве диспетчера соединения в пакет среды Business Intelligence Development Studio.

Копирование компонента в папку «Соединения»

Откройте проводник Windows или другое приложение для работы с файловой системой.
Скопируйте сборки (Excel2ConnMgrCS.dll и Excel2ConnMgrUICS.dll или Excel2ConnMgrVB.dll и Excel2ConnMgrUIVB.dll) в папку Соединения, расположенную по адресу: %system%\Program Files\Microsoft Sql Server\90\Dts.

Установка компонента в глобальный кэш сборок (GAC) путем перетаскивания сборок

Откройте проводник Windows или другое приложение для работы с файловой системой.
Перетащите сборки из папки Connections в папку, где находится глобальный кэш сборок (GAC), в каталоге %system%\assembly.

Установка компонента в глобальный кэш сборок c помощью программы gacutil.exe

Откройте окно «Командная строка».

Введите следующую команду для установки версии компонента на языке C# и пользовательского интерфейса в глобальный кэш сборок:

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"

— или —

введите следующие команды для установки версии компонента и пользовательского интерфейса на языке Visual Basic в глобальный кэш сборок:

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"

Проверка образца

Теперь пользовательский диспетчер соединений можно проверить в пакете.

Использование диспетчера соединений образца в пакете

В области диспетчеров соединений конструктора служб SSIS правой кнопкой мыши щелкните Создать соединение, в списке доступных типов соединений выберите EXCEL2. Нажмите кнопку ОК.

Измените новый диспетчер соединений. В Редакторе диспетчера соединений с Excel2 найдите доступный файл книги Excel. При помощи флажков произведите настройку заголовков и режима импорта.

Примечание.
Образец пользовательского диспетчера соединений с Excel2 нельзя использовать с источником Excel, который поддерживает только встроенный диспетчер соединений с Excel. Лучше проверить его работу с источником DataReader.

Поделиться через