<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 という 2 つの子コレクションを定義します。各コレクションは、エンドポイントとサービスによって使用されるそれぞれの動作要素を定義します。各動作要素は、その一意の name 属性で識別されます。 |
|
この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。各エントリは、その一意の name により識別されます。サービスは、name を使用してバインディングをリンクすることにより、バインディングを使用します。 |
|
この要素は、クライアントがサービスの接続に使用するエンドポイントの一覧を含みます。 |
|
この要素は、WCF と COM 相互運用が有効な COM コントラクトを定義します。 |
|
この要素は、machine.config ファイルでのみ定義できます。このセクションは、endpointBehaviors と serviceBehaviors という 2 つの子コレクションを定義します。各コレクションは、コンピュータ上の WCF のすべてのエンドポイントとサービスによって使用されるそれぞれの動作要素を定義します。ある動作が <commonBehaviors> と <behaviors> の両方のセクションで定義されている場合は、<behaviors> セクション内の動作が優先されます。 |
|
この要素には、拡張のコレクションが含まれています。これにより、ユーザー定義のバインディング、動作、およびその他の拡張機能を作成できるようになります。 |
|
この要素は、WCF の診断機能の設定を含みます。ユーザーはトレース、パフォーマンス カウンタ、および WMI プロバイダを有効または無効にしたり、カスタム メッセージ フィルタを追加したりできます。 |
|
この要素は、環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。このセクションが空の場合は、既定の型が使用されます。 |
|
要素には、サービスのコレクションが含まれています。アセンブリで定義された各サービスの場合、この要素は、サービスの設定を指定する service 要素を含みます。 |
親要素
| 要素 | 説明 |
|---|---|
<configuration> |
.NET 構成ファイルのすべての構成要素のルート要素。 |
解説
WCF は、他の製品の構成セクションに要素を追加しません。
WCF サービスは、構成ファイルの services セクションで定義されます。アセンブリには、任意の数のサービスを含めることができます。各サービスには、独自の service 設定セクションがあります。セクションとその内容は、サービス コントラクト、動作、および特定のサービスのエンドポイントを定義します。
サービスの name 属性だけが必須項目です。既定では、サービスの名前は、サービスの実装に使用される、基になる CLR 型を示します。ただし、ServiceContractAttribute の ConfigurationName プロパティを変更して、CLR 型要件をオーバーライドすることもできます。
behaviorConfiguration 属性は省略できます。サービスが使用するサービス動作を識別します。この属性で指定された動作は、同じ構成ファイルの範囲内に定義されたサービス動作にリンクしている必要があります。
各サービスでは、endpoint 要素で定義された 1 つまたは複数のエンドポイントが公開されます。各エンドポイントには、独自のアドレスおよびバインディングがあります。構成ファイル内で使用されるすべてのバインディングは、そのファイルのスコープ内で定義される必要があります。
バインディングは、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>