<client> の <endpoint>

  • [アーティクル]

サーバーのサービス エンドポイントに接続するためにクライアントによって使用されるチャネル エンドポイントのコントラクト、バインディング、およびアドレスのプロパティを指定します。

<system.serviceModel>
  <client>
    <client> の <endpoint>

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   contract="String"
   name=="String"
</endpoint>

属性および要素

属性

属性 説明

address

必須の文字列属性です。

エンドポイントのアドレスを指定します。既定値は空の文字列です。アドレスは、絶対 URI にする必要があります。

behaviorConfiguration

エンドポイントのインスタンス化に使用される動作の動作名を含む文字列。動作名は、サービスが定義される時点でスコープ内にある必要があります。既定値は空の文字列です。

binding

必須の文字列属性です。

使用するバインディングの種類を示す文字列。参照できるようにするには、種類は登録された構成セクションを持っている必要があります。種類は、バインディングの種類の名前ではなくセクション名で登録されます。

bindingConfiguration

省略可能。エンドポイントがインスタンス化されるときに使用するバインディング構成の名前を含む文字列。バインディング構成は、エンドポイントが定義される時点でスコープ内にある必要があります。既定値は空の文字列です。

この属性は、構成ファイル内の特定のバインディング構成を参照するために、binding と組み合わせて使用されます。カスタム バインディングを使用しようとする場合にこの属性を設定します。そうでない場合は、例外がスローされることがあります。

contract

必須の文字列属性です。

このエンドポイントが公開するコントラクトを示す文字列。アセンブリは、コントラクト型を実装する必要があります。

name

省略可能な文字列属性。この属性は、特定のコントラクトのエンドポイントを一意に識別します。特定のコントラクトの種類に、複数のクライアントを定義できます。それぞれの定義は、一意の構成名で区別できるようにする必要があります。この属性が省略されている場合、指定されたコントラクトの種類に関連する既定のエンドポイントとして、対応するエンドポイントが使用されます。既定値は空の文字列です。

バインディングの name 属性は、WSDL を介した定義エクスポートに使用されます。

子要素

要素 説明

<headers>

アドレス ヘッダーのコレクション。

<identity>

メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする ID です。

親要素

要素 説明

<client>

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

例

これはチャネル エンドポイントの構成の例です。

<endpoint address="/HelloWorld/"
    bindingConfiguration="usingDefaults"
    name="MyBinding"
    binding="customBinding"
    contract="HelloWorld">
</endpoint>

関連項目

リファレンス

ChannelEndpointElement
ClientSection
ChannelEndpointElementCollection
Endpoints
ChannelEndpointElement

その他の技術情報

WCF Client Configuration
Clients