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

Многоязычный образец Hello World Ready

  • Статья

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

Образец Hello World Ready демонстрирует основные операции, применяемые при создании, развертывании и отладке простых общедоступных хранимых процедур на основе интеграции со средой CLR. Общедоступный компонент может быть легко локализован для различных рынков по всему миру без изменения исходного кода компонента. Этот образец также демонстрирует способы возврата данных при помощи выходного параметра и записи, которая динамически создается хранимой процедурой и возвращается клиенту.

Этот образец практически идентичен образцу Hello World — с тем отличием, что он намного легче и безопаснее для размещения этого приложения. Для изменения локализованного текста необходимо:

  1. изменение XML-файла (RESX) для определенной культуры в каталоге ресурсов;
  2. построение файла ресурсов культуры при помощи программы resgen;
  3. построение обновленной DLL-библиотеки дополнения для этой культуры;
  4. удаление и добавление этой сборки в SQL Server.

Исходный код и сборка для самой хранимой процедуры CLR не изменяется. Сценарий build.cmd находится в каталоге ресурсов и демонстрирует компилирование и подключение сборок ресурсов.

Хотя исходный код приложения создает диспетчер ресурсов на основе текущей выполняемой сборки, внедрять нейтральные к культуре ресурсы в DLL-библиотеку, содержащую хранимые процедуры, не надо. Указываемый в файле AssemblyInfo.cs или AssemblyInfo.vb атрибут System.Resources.NeutralResourcesLanguage допускает существование нейтральных к культуре ресурсов в DLL-библиотеке дополнения. Для этой цели лучше использовать отдельный файл DLL, чтобы при добавлении или изменении размещенного текста не пришлось изменять основной файл DLL, содержащий хранимые процедуры CLR. Это особенно удобно для определяемых пользователем типов данных CLR, которые могут содержать столбцы и другие зависимости, затрудняющие удаление и повторное добавление типа.

Как правило, версии DLL дополнения должны быть идентичны версии основной сборки. Однако можно указать атрибут SatelliteContractVersion, чтобы обеспечить обновление основной сборки без обновления сборок дополнения. Дополнительные сведения см. в описании класса ResourceManager в документации по пакету Microsoft .NET Framework версии 2.0 SDK.

Каталог установки: диск:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\HelloWorldReady\

Сценарий

Джейн — разработчик базы данных Adventure Works Cycles. Она должна понять основы использования хранимых процедур интеграции со средой CLR. Она также должна понять, как делать собственные хранимые процедуры интеграции со средой CLR общедоступными при помощи ресурсов, используемых ее компанией.

Языки

Transact-SQL, Visual C# и Visual Basic.

Возможности

Многоязычный образец Hello World Ready использует следующие свойства SQL Server.

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

Все части

Среда CLR, метаданные

Локализация

Ресурсы

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

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

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

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

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

    sn -k SampleKey.snk

    ms160899.note(ru-ru,SQL.90).gifВажно!
    Дополнительные сведения о паре ключей для строгого имени см. в статье по строгим именам и безопасности для платформы .NET Framework в центре разработчиков .NET в MSDN.

Построение многоязычного образца «Hello World Ready»

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

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

  2. Скомпилируйте сборки сателлита, выполнив предоставленный в каталоге ресурсов файл build.cmd в командной строке .NET Framework или Visual Studio. Файл активирует приложение resgen, включенное в пакет Visual Studio или .NET Framework SDK.

  3. Убедитесь, что база данных AdventureWorks установлена.

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

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

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

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

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

Запуск многоязычного образца «Hello World Ready»

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

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

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

Удаление многоязычного образца «Hello World Ready»

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

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

Примечания

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

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

См. также

Задачи

Образец Hello World
Определяемые пользователем типы даты-времени с учетом календаря

Другие ресурсы

CREATE ASSEMBLY (Transact-SQL)
DROP ASSEMBLY (Transact-SQL)
CREATE PROCEDURE (Transact-SQL)
DROP PROCEDURE (Transact-SQL)

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

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

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

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

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