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)
| 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(EndpointDiscoveryMetadata^) | 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. |
| AnnounceOfflineTaskAsync(EndpointDiscoveryMetadata^) | Causes an offline task announcement message (Bye) to be sent asynchronously with the specified endpoint discovery metadata. |
| AnnounceOnline(EndpointDiscoveryMetadata^) | Causes an online announcement message (Hello) to be sent. |
| 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. |
| AnnounceOnlineTaskAsync(EndpointDiscoveryMetadata^) | Causes an online task announcement message (Hello) to be sent asynchronously with the specified endpoint discovery metadata. |
| BeginAnnounceOffline(EndpointDiscoveryMetadata^, AsyncCallback^, Object^) | 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(EndpointDiscoveryMetadata^, AsyncCallback^, Object^) | 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(IAsyncResult^) | Waits for a pending asynchronous offline announcement to complete. |
| EndAnnounceOnline(IAsyncResult^) | 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.) |
| GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
| GetType() | |
| 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::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::Faulted | Occurs when the communication object first enters the faulted state. |
| 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. |
 | IDisposable::Dispose() | Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. |
| 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 within a specified interval of time. |
| ICommunicationObject::EndClose(IAsyncResult^) | Completes an asynchronous operation to close a communication object. |
| ICommunicationObject::EndOpen(IAsyncResult^) | Completes an asynchronous operation to open a communication object. |
| 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::State | Gets the current state of the communication-oriented object. |
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.
Available since 4.0
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.