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

Исходные тексты и собранные модули

Исходные тексты примеров данной главы собраны в файле Simple.zip, который устанавливается в подкаталоге Examples КриптоПро .NET SDK, по умолчанию директория %ProgramFiles(x86)%\Crypto Pro\.NET SDK\Examples. Большинство примеров данной главы реализованы на C# и Visual Basic. Для работы с примерами необходимо распаковать файл с исходными текстами примеров в рабочую директорию (не рекомендуется использовать поддиректории %ProgramFiles(x86)%\Crypto Pro\.NET SDK). Примеры объеденены в каталоги по тематика и ниже уровнем в каталоги по языкам программирования.

В состав КриптоПро .NET SDK входит собранная в Release версии из исходных текстов на C# в виде одной сборки исполняемый файл тестов SimpleCS.exe; данный файл может быть установлен в подкаталог Examples КриптоПро .NET SDK, по умолчанию директория %ProgramFiles(x86)%\Crypto Pro\.NET SDK\Examples.

Сборка и запуск примеров

Существует два основных способа сборки примеров из этого раздела и два соответствующих способа запуска этих примеров:

  • Сборка одного примера. Сборка осуществляется явным вызовом компилятора с передачей ему в качестве параметра имени файла исходного примера, а так же дополнительных параметров компилятора. Например, для сборки примера Certificate2 на CSharp необходимо перейти в католог Certificate\cs и выполнить

    csc.exe /out:Certificate.Certificate2.exe Certificate2

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

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

    Certificate.Certificate2.exe c:\GostT.cer

    Список параметров, которые необходимо передать, указан в комментариях к этому примеру, и/или в документации на пример.

  • Сборка всех элементарных примеров из этой главы в единый исполняемый файл. Сборка может осуществляться вызовом программы msbuild.exe из состава .Net Framework 2.0 или .Net Framework 3.5 или .Net Framework 4.0 с передачей ему имени соответствующего проекта. Например, для сборки примеров на языке CSharp при использовании MSBuild из состава .Net Framework 2.0 необходимо выполнить

    %windir%\Microsoft.NET\Framework\v2.0.50727\MSBuild.exe SimpleCS.20.csproj

    Для сборки примера можно использовать Microsoft Visual Studio как через файл проекта, так и через файл решения (solution). Решения SimpleCS.2005.sln и SimpleVB.2005.sln или проекты SimpleCS.20.csproj и SimpleVB.20.csproj для Microsoft Visual Studio 2005; решения SimpleCS.2008.sln и SimpleVB.2008.sln или проекты SimpleCS.35.csproj и SimpleVB.35.csproj для Microsoft Visual Studio 2008; решения SimpleCS.2010.sln и SimpleVB.2010.sln или проекты SimpleCS.40.csproj и SimpleVB.40.csproj для Microsoft Visual Studio 2010. При сборке через проект, как средствами msbuild так и средствами среды разработки, собранный исполняемый файл копируется в директорию bin\Debug (bin\Release при сборке Release конфигурации).

    Для запуска конкретного примера необходимо перейти в директорию с собранным исполняемым файлом, например bin\Debug, и передать собранной программе в качестве первого параметра полное имя класса (включая пространство имен) исполняемого примера и далее передать остальные параметры для этого примера. Например, для запуска примера Certificate2 на CSharp, необходимо выполнить

    SimpleCS.exe Samples.Certificate.Certificate2 c:\GostT.cer

    При указании поного имени класса корневое пространство имен Samples можно опустить.

    Список всех примеров входящих в сборку может быть получен запуском программы с передечей ему параметра -help, например, для C# версии, так:

    SimpleCS.exe -help

См. также