Образец String Utilities

Образец StringUtilities содержит потоковую возвращающую табличное значение функцию, написанную на языках Visual C# и Visual Basic, которая разбивает разделенную запятыми строку на таблицу с одним столбцом. Он также содержит статистическую функцию, преобразующую строковый столбец в разделенную запятыми строку.

Исходные файлы concat.cs и concat.vb source содержат реализацию статистической функции. Исходные файлы split.cs и split.vb содержат реализацию потоковой возвращающей табличное значение функции. Исходные файлы RegularExpression.cs и RegularExpression.vb реализуют скалярную и возвращающую табличное значение функции, обеспечивающие функциональность поиска и замены с помощью регулярных выражений.

Для реализации потоковой возвращающей табличное значение функции создайте метод, возвращающий объект, который реализует интерфейс IEnumerable. Этот метод интерфейса IEnumerable должен быть связан атрибутом с другим методом, который заполняет строки возвращающей табличное значение функции.

Каталог установки по умолчанию — «диск:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\StringUtilities».

Сценарий

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

Языки

Transact-SQL, Visual C# и Visual Basic.

Возможности

Образец StringUtilities использует следующие возможности SQL Server 2005:

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

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

• SQL Server 2005 или SQL Server 2005 Express Edition (SQL Server Express). SQL Server Express можно получить бесплатно на веб-узле «Документация и образцы SQL Server 2005 Express Edition».
• База данных AdventureWorks, включенная в поставку SQL Server 2005, также доступна в центре разработчиков на SQL Server.
• Образцы компонента SQL Server 2005 Database Engine. Данные образцы входят в комплект SQL Server 2005. Последнюю версию образцов можно загрузить в центре разработчиков на SQL Server.
• Пакет .NET Framework SDK 2.0 или среда Microsoft Visual Studio 2005. Пакет .NET Framework SDK можно получить бесплатно. См. раздел Установка пакета .NET Framework SDK.

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

Чтобы построить образец, выполните следующее.

Если файл ключа для строгого имени еще не создавался, создайте его следующим образом.

To generate a strong name key file

1. Откройте командную строку Microsoft Visual Studio 2005. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

   -- или --

   Откройте командную строку Microsoft .NET Framework. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

2. Используйте команду CD, чтобы сменить текущий каталог командной строки и перейти в каталог, в котором установлены образцы.

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

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

   sn -k SampleKey.snk

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

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

1. Скомпилируйте образец в среде Visual Studio 2005 с помощью предоставляемого решения Visual Studio или программы Microsoft MSBuild, которая включена в пакет .NET Framework SDK 2.0. В окне командной строки выполните следующую команду:

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\StringUtilities.sln

2. Убедитесь, что база данных AdventureWorks установлена, или при необходимости создайте базу данных, в которой будут установлены образцы.

3. Откройте файл scripts\installCS.sql или scripts\installVB.sql, в зависимости от того, какой из проектов, Visual C# или Visual Basic, скомпилирован в среде SQL Server Management Studio. Запустите сценарий, содержащийся в файле, или введите в командной строке команду, подобную следующей:

   sqlcmd -E -I -i Scripts\InstallCS.sql

   Этот файл содержит сценарий, необходимый для установки и регистрации образцов компонентов CLR в SQL Server.

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

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

Запустить образец

1. Откройте файл scripts\test.sql в среде Management Studio и запустите содержащийся в нем сценарий. Либо выполните в командной строке следующую команду:

   sqlcmd -E -I -i Scripts\test.sql

   Этот сценарий показывает типичные способы использования образца.

Удаление образца

Чтобы удалить образец, сделайте следующее.

Удаление образца

1. Откройте файл scripts\cleanup.sql в среде Management Studio и запустите содержащийся в нем сценарий. Либо выполните в командной строке следующую команду:

   sqlcmd -E -I -i Scripts\cleanup.sql

   Этот сценарий удаляет образец.

Примечания

Чтобы этот образец работал правильно, должна быть включена среда CLR для SQL Server 2005 или SQL Server Express.

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

См. также

Основные понятия

Образцы программирования для среды CLR

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений