<endpoint> 要素

  • [アーティクル]

サービスの公開に使用されるサービス エンドポイントのバインディング、コントラクト、およびアドレスのプロパティを指定します。

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>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
address エンドポイントのアドレスを含む文字列。 アドレスは、絶対または相対アドレスとして指定できます。 相対アドレスが提供されている場合、ホストは、そのバインディングで使用されるトランスポート スキームに適したベース アドレスが提供されることを想定します。 アドレスが構成されていない場合、ベース アドレスはそのエンドポイントのアドレスと見なされます。

既定値は空の文字列です。
behaviorConfiguration エンドポイントで使用される動作の名前を含む文字列。
binding 使用するバインディングの種類を指定する必須の文字列属性。 参照できるようにするには、種類は登録された構成セクションを持っている必要があります。 種類は、バインディングの種類の名前ではなくセクション名で登録されます。
bindingConfiguration エンドポイントがインスタンス化されるときに使用するバインディングのバインディング名を指定する文字列。 バインディング名は、エンドポイントが定義される時点でスコープ内にある必要があります。 既定値は空の文字列です。

この属性は、構成ファイル内の特定のバインディング構成を参照するために、binding と組み合わせて使用されます。 カスタム バインドを使用しようとする場合にこの属性を設定します。 そうでない場合は、例外がスローされることがあります。
bindingName WSDL を介した定義エクスポートに使用するバインディングの一意の修飾名を指定する文字列。 既定値は空の文字列です。
bindingNamespace WSDL を介した定義エクスポートに使用するバインディングの名前空間の修飾名を指定する文字列。 既定値は空の文字列です。
コントラクト (contract) このエンドポイントが公開するコントラクトを示す文字列。 アセンブリは、コントラクト型を実装する必要があります。 サービス実装が単一のコントラクトの型を実装する場合は、このプロパティを省略できます。 既定値は空の文字列です。
endpointConfiguration この標準エンドポイントの追加の構成情報を参照する kind 属性によって設定される標準エンドポイントの名前を指定する文字列。 同じ名前を <standardEndpoints> セクションに定義する必要があります。
isSystemEndpoint インフラストラクチャ エンドポイントであるかどうかを指定するブール値。
kind 適用する標準エンドポイントの種類を指定する文字列。 <extensions> セクションまたは machine.config に種類を登録する必要があります。何も指定していない場合は、共通のサービス エンドポイントが作成されます。
listenUriMode リッスンするサービスに提供される ListenUri をトランスポートが処理する方法を指定します。 有効な値は、次のとおりです。

- Explicit
- Unique

既定値は Explicit です。
listenUri サービス エンドポイントがリッスンする URI を指定する文字列。 既定値は空の文字列です。
name 省略可能な属性です。 サービス エンドポイントの名前を指定する文字列。 既定値は、バインディング名とコントラクトの説明の名前を連結した値です。 サービスには複数のエンドポイントが存在する場合があるため、エンドポイントの name 属性はサービスの名前とは異なります。

子要素

要素 説明
<headers> アドレス ヘッダーのコレクション。
<identity> メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする ID です。

親要素

要素 説明
<service> クライアントが接続可能なエンドポイントの一覧を定義する設定セクションです。

例

これはサービス エンドポイントの構成の例です。

<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>

関連項目