共用方式為


<<system.serviceModel>>

此組態區段包含所有 Windows Communication Foundation (WCF) ServiceModel 組態項目。

<system.serviceModel>
    <behaviors>
    </behaviors>
    <bindings>
    </bindings>
    <client>
    </client>
    <comContracts>
    </comContracts>
    <commonBehaviors>
    </commonBehaviors>
    <diagnostics>
    </diagnostics>
    <extensions>
    </extensions>
    <serviceHostingEnvironment>
    </serviceHostingEnvironment>
    <services>
    </services>
</system.serviceModel>

屬性和項目

屬性

子項目

項目 描述

<behaviors>

這個項目會定義兩個名稱為 endpointBehaviorsserviceBehaviors 的子集合。每個集合會定義分別由端點和服務使用的行為項目。每個行為項目都由其唯一的 name 屬性所識別。

<bindings>

這個項目會保存標準和自訂繫結的集合。每一個項目都是由它的唯一 name 所識別。服務會使用 name 來連結繫結,以便利用繫結。

<client>

此項目包含用戶端用於連接服務之端點的清單。

<comContracts>

此項目會定義為 WCF 與 COM interop 啟用的 COM 合約。

<commonBehaviors>

此項目只能定義在 machine.config 檔中。它會定義兩個名為 endpointBehaviorsserviceBehaviors 的子集合。每個集合會分別定義由所有 WCF 端點和電腦上服務所使用的行為項目。如果 <commonBehaviors><behaviors> 區段中都有定義某種行為,則會優先使用 <behaviors> 區段中的行為。

<extensions> 區段

這個項目包含延伸的集合,可讓使用者建立使用者定義的繫結、行為和其他方面的延伸。

<diagnostics>

此項目包含 WCF 診斷功能的設定。使用者可以啟用/停用追蹤、效能計數器和 WMI 提供者,並且可以新增自訂訊息篩選條件。

<serviceHostingEnvironment>

此項目會定義服務裝載環境為特定傳輸具現化的型別。如果這個區段是空白的,便會使用預設的型別。

<services>

此項目包含服務的集合。對於在組件中定義的各個服務,此項目包含指定服務設定的 service 項目。

父項目

項目 描述

<configuration>

.NET 組態檔中所有組態項目的根項目。

備註

WCF 不會在其他產品的組態區段中新增項目。

WCF 服務是在組態檔的 services 區段中定義。組件可包含任何數目的服務。各服務都有自己的 service 組態區段。這個區段及其內容會定義特定服務的服務合約、行為和端點。

只有服務的 name 屬性才需要用到。根據預設,服務名稱會說明用來實作服務的基礎 CLR 型別,但您可變更 ServiceContractAttribute 上的 ConfigurationName 屬性來覆寫 CLR 型別需求。

behaviorConfiguration 屬性是選擇性的,它會識別服務使用的服務行為。此屬性指定的行為必須連結到相同組態檔範圍中 (如同一支檔案或父檔案) 定義的服務行為。

每個服務會公開一或多個 endpoint 項目中定義的端點。每個端點都有自己的位址和繫結。在組態檔中使用的所有繫結都必須定義在檔案的範圍內。

繫結會透過 namebindingConfiguration 屬性的組合連結至端點。binding 屬性會定義在哪一個區段定義繫結,bindingConfiguration 屬性則會定義使用繫節區段中哪一個已設定的繫結。繫結區段可定義數個已設定的繫結。

範例

下列是 WCF 組態檔的範例。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.serviceModel>
        <behaviors>
           <!-- List of Behaviors -->
        </behaviors>
        <client>
           <!-- List of Endpoints -->
        </client>
        <diagnostics wmiProviderEnabled="false" performanceCountersEnabled="false" tracingEnabled="false">
        </diagnostics>
        <serviceHostingEnvironment>
           <!-- List of entries -->
        </serviceHostingEnvironment>
        <comContracts>
           <!-- List of COM+ Contracts -->
        </comContracts>        
        <services>
           <!-- List of Services -->
        </services>
        <bindings>
           <!-- List of Bindings -->
        </bindings>
    </system.serviceModel>
</configuration>

請參閱

參考

ServiceModelSectionGroup