<announcementEndpoint>
この構成要素は、固定アナウンス コントラクトが設定されている標準エンドポイントを定義します。 サービスは、サービスが開いたとき、または閉じたときにオンラインおよびオフラインのアナウンス メッセージを送信することによって、その可用性をアナウンスすることもできます。 Windows Communication Foundation (WCF) サービスは、<serviceDiscovery> 要素でアナウンス エンドポイントを指定し、AnnouncementClient を使用してアナウンスを実行します。 他のサービスからのアナウンスをリッスンしようとするクライアントは、実際に、WCF サービスとして動作します。このため、<services> セクションに、このクライアントのアナウンス エンドポイントを構成する必要があります。
configuration
system.serviceModel
<standardEndpoints>
<announcementEndpoint>
構文
<system.serviceModel>
<standardEndpoints>
<announcementEndpoint>
<standardEndpoint discoveryVersion="WSDiscovery11/WSDiscoveryApril2005"
maxAnnouncementDelay="Timespan"
name="String" />
</announcementEndpoint>
</standardEndpoints>
</system.serviceModel>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 | 説明 |
---|---|
discoveryVersion | WS-Discovery プロトコルの 2 つのバージョンのうち、1 つを指定する文字列。 有効値は WSDiscovery11 と WSDiscoveryApril2005 です。 この値は、DiscoveryVersion 型です。 |
maxAnnouncementDelay | Discovery プロトコルが Hello メッセージを送信するまでの待機時間の最大値を指定する Timespan 値。 メッセージは送信前に 0 からこの属性値の間のランダムな時間だけ待機します。 この属性はランダムな短い待機時間を設定するために使用されるもので、ネットワークが機能しなくなり、すべてのサービスが同時にオンラインに戻ったときにネットワーク ストームが発生することを防ぎます。 |
name | 標準エンドポイントの構成名を指定する文字列。 この名前は、サービス エンドポイントの endpointConfiguration 属性で使用され、標準エンドポイントと構成を関連付けます。 |
子要素
なし。
親要素
要素 | 説明 |
---|---|
<standardEndpoints> | 1 つ以上のプロパティ (アドレス、バインディング、コントラクト) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。 |
例
http およびピア ネットワーク経由でアナウンス メッセージをリッスンするクライアントの例を次に示します。
<services>
<service name="ServiceAnnouncementListener">
<endpoint name="httpAnnouncementEndpoint"
kind="announcementEndpoint"
binding="basicHttpBinding"
address="announcements" />
<endpoint name="peerNetAnnouncementEndpoint"
kind="announcementEndpoint"
binding="peerTcpBinding"
address="net.p2p://discoveryMesh/multicast"
bindingConfiguration="discoveryPeerTcpBindingConfig" />
...
</service>
</services>
<standardEndpoints>
<announcementEndpoint>
<standardEndpoint name="httpAnnouncementEndpoint"
version="WSDiscoveryApril2005" />
<standardEndpoint name="peerNetAnnouncementEndpoint"
version="WSDiscoveryApril2005" />
</announcementEndpoint>
</standardEndpoints>
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET