<<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>
屬性和項目
屬性
無
子項目
項目 | 描述 |
---|---|
這個項目會定義兩個名稱為 endpointBehaviors 和 serviceBehaviors 的子集合。每個集合會定義分別由端點和服務使用的行為項目。每個行為項目都由其唯一的 name 屬性所識別。 |
|
這個項目會保存標準和自訂繫結的集合。每一個項目都是由它的唯一 name 所識別。服務會使用 name 來連結繫結,以便利用繫結。 |
|
此項目包含用戶端用於連接服務之端點的清單。 |
|
此項目會定義為 WCF 與 COM interop 啟用的 COM 合約。 |
|
此項目只能定義在 machine.config 檔中。它會定義兩個名為 endpointBehaviors 和 serviceBehaviors 的子集合。每個集合會分別定義由所有 WCF 端點和電腦上服務所使用的行為項目。如果 <commonBehaviors> 和 <behaviors> 區段中都有定義某種行為,則會優先使用 <behaviors> 區段中的行為。 |
|
這個項目包含延伸的集合,可讓使用者建立使用者定義的繫結、行為和其他方面的延伸。 |
|
此項目包含 WCF 診斷功能的設定。使用者可以啟用/停用追蹤、效能計數器和 WMI 提供者,並且可以新增自訂訊息篩選條件。 |
|
此項目會定義服務裝載環境為特定傳輸具現化的型別。如果這個區段是空白的,便會使用預設的型別。 |
|
此項目包含服務的集合。對於在組件中定義的各個服務,此項目包含指定服務設定的 service 項目。 |
父項目
項目 | 描述 |
---|---|
<configuration> |
.NET 組態檔中所有組態項目的根項目。 |
備註
WCF 不會在其他產品的組態區段中新增項目。
WCF 服務是在組態檔的 services 區段中定義。組件可包含任何數目的服務。各服務都有自己的 service 組態區段。這個區段及其內容會定義特定服務的服務合約、行為和端點。
只有服務的 name 屬性才需要用到。根據預設,服務名稱會說明用來實作服務的基礎 CLR 型別,但您可變更 ServiceContractAttribute 上的 ConfigurationName 屬性來覆寫 CLR 型別需求。
behaviorConfiguration 屬性是選擇性的,它會識別服務使用的服務行為。此屬性指定的行為必須連結到相同組態檔範圍中 (如同一支檔案或父檔案) 定義的服務行為。
每個服務會公開一或多個 endpoint 項目中定義的端點。每個端點都有自己的位址和繫結。在組態檔中使用的所有繫結都必須定義在檔案的範圍內。
繫結會透過 name 和 bindingConfiguration 屬性的組合連結至端點。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>