Образец компонента Change Case

Статья
12/15/2008

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

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

Важно!
Образцы кода «Data Flow Programming» служб Integration Services предназначены для демонстрации возможностей ядра, которые должны быть реализованы для создания пользовательского компонента потока данных. В образцы не входит полная поддержка настройки в Расширенном редакторе. Например, нельзя использовать Расширенный редактор для добавления или удаления входов и выходов, а также для настройки столбцов. Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Майкрософт не предоставляет техническую поддержку для этих образцов.

Образцы кода «Data Flow Programming» служб Integration Services предназначены для демонстрации возможностей ядра, которые должны быть реализованы для создания пользовательского компонента потока данных. В образцы не входит полная поддержка настройки в Расширенном редакторе. Например, нельзя использовать Расширенный редактор для добавления или удаления входов и выходов, а также для настройки столбцов. Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Майкрософт не предоставляет техническую поддержку для этих образцов.

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

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

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

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

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

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

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

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

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

Сведения о двухэтапном процессе установки образцов см. в разделе Установка образцов. Чтобы получить последнюю версию образцов, включая новые, выпущенные после исходной версии 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.

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

В меню Файл выберите пункт Открыть, Проект, а затем откройте файл ChangeCase.sln в для нужного языка программирования.
Чтобы построить проект, в меню Построить выберите пункт Построить ChangeCase.

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

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

Копирование компонента в папку PipelineComponents

Откройте проводник Windows или любое другое приложения для работы с файловой системой.
Скопируйте сборку (ChangeCaseCS.dll или ChangeCaseVB.dll) в папку PipelineComponents, расположенную в каталоге %system%\Program Files\Microsoft SQL Server\90\DTS.

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

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

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

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

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

- or -

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

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

Добавление компонента в область элементов

Откройте среду Business Intelligence Development Studio.
Щелкните область элементов правой кнопкой мыши и выберите пункт Выбрать элементы.
В диалоговом окне Выбор элементов области элементов перейдите на вкладку Элементы потока данных служб SSIS.

Установите флажок рядом с необходимым компонентом и нажмите кнопку ОК.

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

После выполнения этих шагов компонент появится в разделе области элементов «Преобразования потока данных» и его можно будет добавить в задачу «Поток данных» в конструкторе.

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

После того как компонент добавлен в задачу «Поток данных» пакета и соединен с компонентом, который должен поставлять ему строки, можно настроить его в конструкторе служб SSIS следующим образом.

Настройка образца компонента в пакете

Выберите вкладку Входные столбцы в Расширенном редакторе, а затем выберите столбцы, которые будут изменены компонентом. Тип использования выбранных столбцов должен быть установлен на «Чтение или Запись», поскольку компонент изменяет значения в столбце в процессе обработки каждой строки поступающих данных.
Выберите вкладку Свойства столбца в Расширенном редакторе, чтобы указать индекс знаков с отсчетом от нуля, которые должны быть изменены в каждом входном столбце, и чтобы указать, должен ли регистр знака в этом индексе быть изменен на верхний (0) или на нижний (1).

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