EndpointDispatcher Classe

Definizione

Rappresenta l'oggetto runtime che espone le proprietà che consentono di inserire estensioni o modifiche della fase di esecuzione per i messaggi delle applicazioni di servizio.Represents the run-time object that exposes properties that enable the insertion of run-time extensions or modifications for messages in service applications.

public ref class EndpointDispatcher sealed
public sealed class EndpointDispatcher
type EndpointDispatcher = class
Public NotInheritable Class EndpointDispatcher
Ereditarietà
EndpointDispatcher

Esempi

L'esempio di codice seguente illustra come utilizzare la classe EndpointDispatcher per individuare System.ServiceModel.Dispatcher.DispatchRuntime dell'endpoint e inserisce un controllo messaggi personalizzato utilizzando un comportamento dell'endpoint.The following code example shows the use of EndpointDispatcher to locate the System.ServiceModel.Dispatcher.DispatchRuntime for the endpoint and inserts a custom message inspector using an endpoint behavior.

// IEndpointBehavior Members
public void AddBindingParameters(ServiceEndpoint serviceEndpoint, System.ServiceModel.Channels.BindingParameterCollection bindingParameters)
{
  return;
}

public void ApplyClientBehavior(ServiceEndpoint serviceEndpoint, ClientRuntime behavior)
{
  behavior.MessageInspectors.Add(new EndpointBehaviorMessageInspector());
}

public void ApplyDispatchBehavior(ServiceEndpoint serviceEndpoint, EndpointDispatcher endpointDispatcher)
{
  endpointDispatcher.DispatchRuntime.MessageInspectors.Add(new EndpointBehaviorMessageInspector());
}

public void Validate(ServiceEndpoint serviceEndpoint)
{
  return;
}

Commenti

Le classi EndpointDispatcher e System.ServiceModel.Dispatcher.DispatchRuntime che espongono i punti di personalizzazione della fase di esecuzione per gli endpoint di un servizio.The EndpointDispatcher and the System.ServiceModel.Dispatcher.DispatchRuntime classes expose the runtime customization points for endpoints in a service. La classe EndpointDispatcher può essere utilizzata per controllare quali messaggi possono essere elaborati e alcune informazioni relative all'endpoint.The EndpointDispatcher can be used to control which messages it can process and some endpoint-related information. La classe DispatchRuntime è dotata di molte proprietà utilizzate per inserire estensioni personalizzate nella fase di esecuzione dell'endpoint.The DispatchRuntime has a large number of properties used to insert custom extensions into the endpoint-wide runtime.

L'oggetto EndpointDispatcher è responsabile per l'elaborazione dei messaggi provenienti da una classe System.ServiceModel.Dispatcher.ChannelDispatcher quando l'indirizzo di destinazione di un messaggio corrisponde alla proprietà AddressFilter e l'azione del messaggio corrisponde alla proprietà ContractFilter.The EndpointDispatcher object is responsible for processing messages from a System.ServiceModel.Dispatcher.ChannelDispatcher when the destination address of a message matches the AddressFilter property and the message action matches the ContractFilter property. Se due oggetti EndpointDispatcher possono accettare un messaggio, il valore della proprietà FilterPriority determina l'endpoint con la priorità più elevata.If two EndpointDispatcher objects can accept a message, the FilterPriority property value determines the higher priority endpoint.

Utilizzare l'oggetto EndpointDispatcher per configurare o estendere la ricezione dei messaggi dalla classe ChannelDispatcher associata, la conversione degli oggetti messaggio in oggetti utilizzati come parametri e la procedura di richiamo di un'operazione dell'endpoint e della procedura inversa.Use the EndpointDispatcher object to configure or extend the process of receiving messages from the associated ChannelDispatcher, converting from message objects to objects used as parameters, and invoking an endpoint operation as well as the reverse process.

In genere, la classe EndpointDispatcher per un endpoint si ottiene implementando l'interfaccia IEndpointBehavior, ma è possibile accedere a EndpointDispatcher anche dalle altre interfacce di comportamento.Typically, the EndpointDispatcher for an endpoint is obtained by implementing the IEndpointBehavior interface, but you can access the EndpointDispatcher from the other behavior interfaces.

È possibile utilizzare le seguenti proprietà EndpointDispatcher:You can use the following EndpointDispatcher properties:

Costruttori

EndpointDispatcher(EndpointAddress, String, String)

Inizializza una nuova istanza della classe EndpointDispatcher con l'indirizzo, il nome del contratto e lo spazio dei nomi del contratto specificati.Initializes a new instance of the EndpointDispatcher class with the specified address, contract name, and contract namespace.

EndpointDispatcher(EndpointAddress, String, String, Boolean)

Inizializza una nuova istanza della classe EndpointDispatcher con l'indirizzo specificato, nome del contratto, spazio dei nomi del contratto e se l'endpoint è un endpoint di sistema pubblico.Initializes a new instance of the EndpointDispatcher class with the specified address, contract name, contract namespace, and whether the endpoint is a public, system endpoint.

Proprietà

AddressFilter

Ottiene o imposta un oggetto MessageFilter utilizzato per identificare se un messaggio specifico è destinato all'indirizzo dell'endpoint.Gets or sets a MessageFilter object that is used to identify whether a particular message is destined for the endpoint address.

ChannelDispatcher

Ottiene l'oggetto ChannelDispatcher associato, da usare per controllare o modificare altri valori e comportamenti relativi al canale.Gets the associated ChannelDispatcher object, which can be used to inspect or modify other channel-related values and behaviors.

ContractFilter

Ottiene o imposta l'oggetto MessageFilter da utilizzare per identificare se un messaggio è destinato al contratto specifico.Gets or sets the MessageFilter object that is used to identify whether a message is destined for this contract.

ContractName

Ottiene il nome del contratto dell'endpoint.Gets the endpoint contract name.

ContractNamespace

Ottiene lo spazio dei nomi del contratto dell'endpoint.Gets the namespace of the endpoint contract.

DispatchRuntime

Ottiene l'oggetto DispatchRuntime utilizzato per controllare, modificare o estendere il comportamento della fase di esecuzione in un endpoint del servizio o in un endpoint di callback client.Gets the DispatchRuntime object used to inspect, modify, or extend run-time behavior across a service endpoint or a client callback endpoint.

EndpointAddress

Ottiene l'indirizzo dell'endpoint.Gets the address of the endpoint.

FilterPriority

Ottiene o imposta la priorità di ContractFilter e della combinazione AddressFilter quando ChannelDispatcher seleziona gli endpoint.Gets or sets the priority of the ContractFilter and the AddressFilter combination when the ChannelDispatcher is selecting endpoints.

IsSystemEndpoint

Ottiene un valore che indica se l'endpoint è stato creato internamente dal server e non dall'utente.Gets a value that indicates whether the endpoint is created internally by the server and not by the user.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a