Как использовать программу Svcutil.exe для экспорта метаданных из скомпилированного кода службы

При помощи Svcutil.exe можно экспортировать метаданные для служб, контрактов и типов данных в скомпилированных сборках, как показано далее.

• Для экспорта метаданных всех скомпилированных контрактов службы для набора сборок при помощи Svcutil.exe необходимо указать сборки как входные параметры. Это поведение установлено по умолчанию.

• Для экспорта метаданных скомпилированной службы для набора сборок при помощи Svcutil.exe необходимо указать сборку службы как входные параметры. Для указания имени конфигурации экспортируемой службы необходимо использовать параметр /serviceName. Svcutil.exe автоматически загружает файл конфигурации для указанной сборки исполняемого файла.

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

Примечание
Для указания пути к файлам любых зависимых сборок используется параметр /reference.

Экспорт метаданных в скомпилированные контракты службы

1. Скомпилируйте реализации контракта службы в одну или несколько библиотек классов.1

2. Запустите Svcutil.exe в скомпилированных сборках.

   Примечание
   Для указания пути к файлам любых зависимых сборок может понадобиться использование параметра /reference.

   svcutil.exe Contracts.dll
   

Экспорт метаданных в скомпилированную службу

1. Скомпилируйте реализацию службы в исполняемую сборку.

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

   <?xml version="1.0" encoding="utf-8" ?>
   <configuration>
     <system.serviceModel>
       <services>
         <service name="MyService" >
           <endpoint address="finder" contract="IPeopleFinder" binding="wsHttpBinding" />
         </service>
       </services>
     </system.serviceModel>
   </configuration>
   

3. Чтобы указать имя конфигурации службы, необходимо запустить Svcutil.exe в скомпилированном исполняемом файле службы при помощи параметра /serviceName.

   Примечание
   Для указания пути к файлам любых зависимых сборок может понадобиться использование параметра /reference.

   svcutil.exe /serviceName:MyService Service.exe /reference:path/Contracts.dll
   

Экспорт метаданных в скомпилированные контракты данных

1. Скомпилируйте реализации контракта данных в одну или несколько библиотек классов.

2. Чтобы задать генерацию только метаданных для контрактов данных, запустите Svcutil.exe в скомпилированных сборках с параметром /dataContract.

   Примечание
   Для указания пути к файлам любых зависимых сборок может понадобиться использование параметра /reference.

   svcutil.exe /dataContractOnly Contracts.dll
   

Пример

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

Экспорт метаданных в контракт службы.

svcutil.exe Contracts.dll

Экспорт метаданных в контракты данных.

svcutil.exe /dataContractOnly Contracts.dll

Экспорт метаданных в реализацию службы.

svcutil.exe /serviceName:MyService Service.exe /reference:<path>/Contracts.dll

<path> является путем к файлу Contracts.dll.

// The following service contract and data contracts are compiled into 
// Contracts.dll.
[ServiceContract(ConfigurationName="IPeopleFinder")]
public interface IPersonFinder
{
    [OperationContract]
    Address GetAddress(Person s);
}

[DataContract]
public class Person
{
    [DataMember]
    public string firstName;
    [DataMember]
    public string lastName;
    [DataMember]
    public int age;
}

[DataContract]
public class Address
{
    [DataMember]
    public string city;
    [DataMember]
    public string state;
    [DataMember]
    public string street;
    [DataMember]
    public int zipCode;
    [DataMember]
    public Person person;
}

// The following service implementation is compiled into Service.exe.   
// This service uses the contracts specified in Contracts.dll.
[ServiceBehavior(ConfigurationName = "MyService")]
public class MyService : IPersonFinder
{
    public Address GetAddress(Person person)
    {
        Address address = new Address();
        address.person = person;
        return address;
    }
}

<!-- The following is the configuration file for Service.exe. -->
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="MyService">
         <endpoint  address="finder"
                    binding="basicHttpBinding"
                    contract="IPeopleFinder"/>
      </service>
    </services>
  </system.serviceModel>
</configuration>
    

См. также

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

Служебное средство ServiceModel Metadata Utility Tool (Svcutil.exe)
Экспорт и импорт метаданных