<announcementEndpoint>
這個組態項目會定義具有固定公告合約的標準端點。 服務可以選擇性地公告其可用性,方法是分別在開啟與關閉該服務時傳送線上及離線公告訊息。 Windows Communication Foundation (WCF) 服務會指定 <serviceDiscovery> 元素的公告端點,並使用 AnnouncementClient 來執行公告。 希望接聽其他服務的公告時,用戶端會實際作為 WCF 服務,所以您必須在 <services> 區段設定該用戶端的公告端點。
<configuration>
<system.serviceModel>
<standardEndpoints>
<announcementEndpoint>
Syntax
<system.serviceModel>
<standardEndpoints>
<announcementEndpoint>
<standardEndpoint discoveryVersion="WSDiscovery11/WSDiscoveryApril2005"
maxAnnouncementDelay="Timespan"
name="String" />
</announcementEndpoint>
</standardEndpoints>
</system.serviceModel>
屬性和項目
下列章節說明屬性、子元素和父元素。
屬性
屬性 | 描述 |
---|---|
discoveryVersion | 字串,此字串會指定兩個 WS-Discovery 通訊協定版本的其中之一。 有效的值為 WSDiscovery11 和 WSDiscoveryApril2005。 這個值的型別為 DiscoveryVersion。 |
maxAnnouncementDelay | Timespan 值,這個值指定 Discovery 通訊協定傳送 Hello 訊息之前會等候的延遲值上限。 系統會等候一段隨機時間值 (介於 0 和此屬性的值之間),之後才傳送訊息。 這個屬性用於設定一小段隨機的延遲,避免網路關閉而所有服務同時再次上線時網路負荷過大。 |
NAME | 字串,這個字串會指定標準端點之組態的名稱。 這個名稱用於服務端點的 endpointConfiguration 屬性中,可將標準端點連結至其組態。 |
子元素
無。
父項目
元素 | 描述 |
---|---|
<standardEndpoints> | 標準端點的集合,這些端點是預先定義的端點,其中包含一個或多個固定的屬性 (位址、繫結、合約)。 |
範例
下列範例示範透過 http 及 peernet 接聽公告訊息的用戶端。
<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>