Образец HtmlLogProvider

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

Образец HtmlLogProvider демонстрирует создание особого регистратора событий, Html Log Provider, записывающего выходные данные журнала в HTML-документ.

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

Особый регистратор событий использует имя файла назначения с расширением .htm или .html из существующего диспетчера подключений файлов. Этот регистратор записывает выходные данные событий в HTML-таблицу в указанном целевом файле, не учитывая последние два стандартных столбца (dataCode и dataBytes), которые могут содержать двоичные данные, неправильно отображаемые в HTML-документе. В образце HTML-код регистрации инкапсулируется в отдельный класс поддержки HtmlLogWriter для удобства повторного использования. Этот класс поддержки включает подпрограммы OpenLogHtml, LogHtml и CloseLogHtml, вызываемые из OpenLog, Log и CloseLog соответственно. Этот образец не поддерживается в операционных системах на платформе Itanium.

Этот образец кода обеспечивает следующие функции:

• перекрывание класса LogProviderBase;
• обеспечение сохранения состояния по умолчанию (чтобы разработчику не приходилось писать для этого код).

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

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

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

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

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

• Microsoft Visual Studio 2005
• Microsoft SQL Server 2005 Integration Services

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

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

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

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

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

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

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

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

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

   — или —

   Чтобы открыть командную строку Microsoft .NET Framework, нажмите кнопку Пуск, укажите последовательно пункты Все программы, Microsoft .NET Framework SDK 2.0, а затем выберите пункт Командная строка пакета SDK.

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

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

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

   sn -k SampleKey.snk
   

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

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

1. В меню Файл | Открыть выберите пункт Проект и откройте файл HtmlLogProviderVB.sln или HtmlLogProviderCS.sln.

2. В меню Построить выберите пункт Построить решение, чтобы выполнить построение решения.

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

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

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

1. Откройте проводник Windows или другое приложение для работы с файловой системой.

2. Скопируйте сборку (HtmlLogProviderCS.dll или HtmlLogProviderVB.dll) в папку LogProviders, расположенную по адресу: %system%\Program Files\Microsoft SQL Server\90\DTS.

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

1. Откройте проводник Windows или другое приложение для работы с файловой системой.

2. Перетащите сборку из папки LogProviders в папку, где расположен глобальный кэш сборок (GAC), в %system%\assembly.

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

1. Откройте окно командной строки.

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

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

   — или —

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

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

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

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

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

1. В проекте служб Integration Services добавьте новый диспетчер подключения файлов и настройте его таким образом, чтобы он указывал на файл с расширением **.**htm или **.**html.

2. В меню SSIS выберите Ведение журнала и добавьте особый регистратор для HTML-файлов (CS) или особый регистратор для HTML-файлов (VB).

3. В столбце «Конфигурация» введите имя диспетчера подключения файлов.

4. Настройте ведение журнала таким образом, чтобы события пакета и его компонентов записывались пользовательским регистратором.

5. Запустите пакет, затем откройте HTML-файл, чтобы просмотреть выходные данные журнала.