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

Определяемый пользователем тип для строк UTF8

  • Статья

Изменения: 5 декабря 2005 г.

Образец UTF8String для SQL Server 2005 демонстрирует реализацию пользовательского типа данных. Этот образец показывает реализацию определяемого пользователем типа данных UTF8, который расширяет систему типов базы данных, обеспечивая возможность хранения значений в кодировке UTF8. Этот тип также реализует программный код для преобразования строк в Юникоде в формат UTF8 и обратно.

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

Сценарий

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

Языки

Transact-SQL, Visual C# и Visual Basic.

Возможности

В образце UTF8String использованы следующие возможности SQL Server 2005.

Часть образца Возможности

Все части

Среда CLR

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

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

  • 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, чтобы сменить текущий каталог командной строки и перейти в каталог, в котором установлены образцы.

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

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

    sn -k SampleKey.snk

    ms160893.note(ru-ru,SQL.90).gifВажно!
    Дополнительные сведения о паре ключей для строгого имени см. в статье по строгим именам и безопасности для платформы .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\UTF8String.sln

  2. Должна быть установлена база данных AdventureWorks.

  3. Если образцы ядра SQL Server Database Engine установлены не в каталог по умолчанию, измените путь в разделе сценария CREATE ASSEMBLY в файлах Scripts\InstallCS.sql и Scripts\InstallVB.sql, указав место установки образцов.

  4. Если вы не являетесь администратором используемого экземпляра SQL Server, для завершения установки необходимо, чтобы администратор предоставил разрешения CreateAssembly.

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

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

    Этот файл содержит сценарий для установки и регистрации пользовательских типов данных в 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

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

Версия Журнал

5 декабря 2005 г.
Измененное содержимое
  • Изменены инструкции по созданию файла ключа, в том числе его имя и расположение.