作法：使用 Svcutil.exe 來匯出已編譯服務程式碼的中繼資料

  • 發行項

Svcutil.exe 可匯出服務中繼資料、合約以及編譯組件資料類型，如下：

  • 若要使用 Svcutil.exe 針對組件集合匯出所有編譯服務合約的中繼資料，請指定組件為輸入參數。 這是預設行為。

  • 若要使用 Svcutil.exe 針對編譯服務匯出中繼資料，請指定服務組件或將組件指定為輸入參數。 您必須使用 /serviceName 選項指示您想要匯出之服務的組態名稱。 Svcutil.exe 自動載入特定可執行組件的組態檔。

  • 若要匯出組件集合內所有資料合約類型，請使用 /dataContractOnly 選項。

注意

使用 /reference 選項為任何相依組件指定檔案路徑。

若要匯出編譯服務合約的中繼資料

  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. 使用 /serviceName 參數指定服務組態名稱，以 Svcutil.exe 處理編譯服務可執行檔。

    注意

    您可能需要使用 /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>

另請參閱