AnnouncementClient Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.
public ref class AnnouncementClient sealed : IDisposable, System::ServiceModel::ICommunicationObject
public sealed class AnnouncementClient : IDisposable, System.ServiceModel.ICommunicationObject
type AnnouncementClient = class
interface ICommunicationObject
interface IDisposable
Public NotInheritable Class AnnouncementClient
Implements ICommunicationObject, IDisposable
- Inheritance
-
AnnouncementClient
- Implements
Remarks
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.
Constructors
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. |
Properties
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. |
Methods
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() |
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) |
Events
AnnounceOfflineCompleted |
Occurs when an asynchronous offline announcement (Bye) completes. |
AnnounceOnlineCompleted |
Occurs when an asynchronous online announcement (Hello) completes. |
Explicit Interface Implementations
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.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(IAsyncResult) |
Completes an asynchronous operation to close a communication object. |
ICommunicationObject.EndOpen(IAsyncResult) |
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. |