サービスを公開するために使用されるサービス エンドポイントのバインド、コントラクト、およびアドレスのプロパティを指定します。
<configuration>
<system.serviceModel>
<services>
<service>
<endpoint>
構文
<endpoint address="String"
behaviorConfiguration="String"
binding="String"
bindingConfiguration="String"
bindingName="String"
bindingNamespace="String"
contract="String"
endpointConfiguration="String"
isSystemEndpoint="Boolean"
kind="String"
listenUriMode="Explicit/Unique"
listenUri="Uri">
</endpoint>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
Attributes
| 特性 | Description |
|---|---|
| address | エンドポイントのアドレスを含む文字列。 アドレスは、絶対アドレスまたは相対アドレスとして指定できます。 相対アドレスが指定されている場合、ホストはバインディングで使用されるトランスポート スキームに適したベース アドレスを提供することが期待されます。 アドレスが構成されていない場合、ベース アドレスはそのエンドポイントのアドレスであると見なされます。 既定値は空の文字列です。 |
| behaviorConfiguration | エンドポイントで使用する動作の名前を含む文字列。 |
| バインディング | 使用するバインディングの種類を指定する必須の文字列属性。 参照するには、型に登録済みの構成セクションが必要です。 型は、バインディングの型名ではなく、セクション名によって登録されます。 |
| bindingConfiguration | エンドポイントのインスタンス化時に使用するバインディングのバインド名を指定する文字列。 バインディング名は、エンドポイントが定義されている時点でスコープ内にある必要があります。 既定値は空の文字列です。 この属性は、構成ファイル内の特定のバインド構成を参照するために、 binding と組み合わせて使用されます。 カスタム バインドを使用する場合は、この属性を設定します。 それ以外の場合は、例外がスローされる可能性があります。 |
| bindingName | WSDL を介した定義エクスポートのバインディングの一意の修飾名を指定する文字列。 既定値は空の文字列です。 |
| bindingNamespace | WSDL を介した定義エクスポートのバインディングの名前空間の修飾名を指定する文字列。 既定値は空の文字列です。 |
| コントラクト | このエンドポイントが公開しているコントラクトを示す文字列。 アセンブリはコントラクト型を実装する必要があります。 サービス実装で 1 つのコントラクト型が実装されている場合は、このプロパティを省略できます。 既定値は空の文字列です。 |
| endpointConfiguration |
kind属性によって設定される標準エンドポイントの名前を指定する文字列。この属性は、この標準エンドポイントの追加の構成情報を参照します。
<standardEndpoints> セクションで同じ名前を定義する必要があります。 |
| isSystemEndpoint | エンドポイントがインフラストラクチャ エンドポイントであるかどうかを示すブール値。 |
| kind | 適用される標準エンドポイントの種類を指定する文字列。 型は、 <extensions> セクションまたは machine.configに登録する必要があります。何も指定しない場合は、共通のサービス エンドポイントが作成されます。 |
| listenUriMode | サービスがリッスンするために提供される ListenUri をトランスポートが処理する方法を指定します。 有効な値は次のとおりです。-明示的 -一意 既定値は Explicit です。 |
| Listenuri | サービス エンドポイントがリッスンする URI を指定する文字列。 既定値は空の文字列です。 |
| 名前 | 省略可能な属性です。 サービス エンドポイントの名前を指定する文字列。 既定値は、バインディング名とコントラクト記述名の連結です。 サービスには複数のエンドポイントが含まれる場合があるため、エンドポイントの name 属性はサービスの名前とは異なります。 |
子要素
| 要素 | Description |
|---|---|
| <ヘッダー> | アドレス ヘッダーのコレクション。 |
| <Id> | メッセージを交換する他のエンドポイントによるエンドポイントの認証を有効にする ID。 |
親要素
| 要素 | Description |
|---|---|
| <サービス> | クライアントが接続できるエンドポイントの一覧を定義する構成セクション。 |
Example
サービス エンドポイント構成の例を次に示します。
<endpoint address="/HelloWorld/"
bindingConfiguration="usingDefaults"
bindingName="MyBinding"
binding="customBinding"
contract="HelloWorld">
<headers>
<region xmlns="http://tempuri.org/">EastCoast</region>
<member xmlns="http://tempuri.org/">Gold</member>
</headers>
</endpoint>
こちらも参照ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET