AnnouncementClient Class
Used by services to send discovery announcement messages. Clients can use the discovery mechanism, specifically the corresponding AnnouncementService class to listen and act on the announcement messages. An announcement message contains information about the service such as its fully-qualified contract name, any scopes that the service is operating in as well as any custom metadata the service wants to send.
Assembly: System.ServiceModel.Discovery (in System.ServiceModel.Discovery.dll)
The AnnouncementClient type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | AnnouncementClient() | Creates a new instance of the AnnouncementClient class. |
![]() | AnnouncementClient(AnnouncementEndpoint) | Initializes a new instance of the AnnouncementClient class with the specified AnnouncementEndpoint. |
![]() | AnnouncementClient(String) | Initializes a new instance of the AnnouncementClient class with the specified endpoint configuration. |
| Name | Description | |
|---|---|---|
![]() | ChannelFactory | Gets the channel factory associated with the AnnouncementClient. |
![]() | ClientCredentials | Gets the client credentials associated with the AnnouncementClient. |
![]() | Endpoint | Gets the ServiceEndpoint associated with the AnnouncementClient. |
![]() | InnerChannel | Gets the inner channel associated with the AnnouncementClient. |
![]() | MessageSequenceGenerator | Gets or sets the message sequence generator associated with the AnnouncementClient. |
| Name | Description | |
|---|---|---|
![]() | AnnounceOffline | Causes an offline announcement message (Bye) to be sent with the specified endpoint discovery metadata. |
![]() | AnnounceOfflineAsync(EndpointDiscoveryMetadata) | Causes an offline announcement message (Bye) to be sent asynchronously with the specified endpoint discovery metadata. |
![]() | AnnounceOfflineAsync(EndpointDiscoveryMetadata, Object) | Causes an offline announcement message (Bye) to be sent asynchronously with the specified endpoint discovery metadata and user-defined state. |
![]() | AnnounceOnline | Causes an online announcement message (Hello) to be sent asynchronously. |
![]() | AnnounceOnlineAsync(EndpointDiscoveryMetadata) | Causes an online announcement (Hello) message to be sent asynchronously with the specified endpoint discovery metadata. |
![]() | AnnounceOnlineAsync(EndpointDiscoveryMetadata, Object) | Causes an online announcement (Hello) message to be sent asynchronously with the specified endpoint discovery metadata and user-defined state. |
![]() | BeginAnnounceOffline | Causes an offline announcement (Bye) message to be sent asynchronously with the specified endpoint discovery metadata and user-defined state. The specified AsyncCallback is called when the operation completes. |
![]() | BeginAnnounceOnline | Causes an online announcement (Hello) message to be sent asynchronously with the specified endpoint discovery metadata and user-defined state. The specified AsyncCallback is called when the operation completes. |
![]() | Close | Closes the AnnouncementClient. |
![]() | EndAnnounceOffline | Waits for a pending asynchronous offline announcement to complete. |
![]() | EndAnnounceOnline | Waits for a pending asynchronous online announcement to complete. |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | Open | Opens the AnnouncementClient. |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() | AnnounceOfflineCompleted | Occurs when an asynchronous offline announcement (Bye) completes. |
![]() | AnnounceOnlineCompleted | Occurs when an asynchronous online announcement (Hello) completes. |
| Name | Description | |
|---|---|---|
![]() ![]() | ICommunicationObject::Abort | Causes a communication object to transition immediately from its current state into the closed state. |
![]() ![]() | ICommunicationObject::BeginClose(AsyncCallback, Object) | Begins an asynchronous operation to close a communication object. |
![]() ![]() | ICommunicationObject::BeginClose(TimeSpan, AsyncCallback, Object) | Begins an asynchronous operation to close a communication object with a specified timeout. |
![]() ![]() | ICommunicationObject::BeginOpen(AsyncCallback, Object) | Begins an asynchronous operation to open a communication object. |
![]() ![]() | ICommunicationObject::BeginOpen(TimeSpan, AsyncCallback, Object) | Begins an asynchronous operation to open a communication object within a specified interval of time. |
![]() ![]() | ICommunicationObject::Close() | Causes a communication object to transition from its current state into the closed state. |
![]() ![]() | ICommunicationObject::Close(TimeSpan) | Causes a communication object to transition from its current state into the closed state. |
![]() ![]() | ICommunicationObject::Closed | Occurs when the communication object completes its transition from the closing state into the closed state. |
![]() ![]() | ICommunicationObject::Closing | Occurs when the communication object first enters the closing state. |
![]() ![]() | ICommunicationObject::EndClose | Completes an asynchronous operation to close a communication object. |
![]() ![]() | ICommunicationObject::EndOpen | Completes an asynchronous operation to open a communication object. |
![]() ![]() | ICommunicationObject::Faulted | Occurs when the communication object first enters the faulted state. |
![]() ![]() | ICommunicationObject::Open() | Causes a communication object to transition from the created state into the opened state. |
![]() ![]() | ICommunicationObject::Open(TimeSpan) | Causes a communication object to transition from the created state into the opened state within a specified interval of time. |
![]() ![]() | ICommunicationObject::Opened | Occurs when the communication object completes its transition from the opening state into the opened state. |
![]() ![]() | ICommunicationObject::Opening | Occurs when the communication object first enters the opening state. |
![]() ![]() | ICommunicationObject::State | Gets the current state of the communication-oriented object. |
![]() ![]() | IDisposable::Dispose | Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. |
If a service adds the ServiceDiscoveryBehavior behavior and specifies an AnnouncementEndpoint the service automatically sends announcement messages when the service goes online or comes offline. Use this class when you want to explicitly send the announcement messages yourself.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.


