ChannelDispatcher Klasse

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Quelle:

ChannelDispatcher.cs

Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet.

public ref class ChannelDispatcher : System::ServiceModel::Dispatcher::ChannelDispatcherBase

public class ChannelDispatcher : System.ServiceModel.Dispatcher.ChannelDispatcherBase

type ChannelDispatcher = class
    inherit ChannelDispatcherBase

Public Class ChannelDispatcher
Inherits ChannelDispatcherBase

Vererbung

Object

CommunicationObject

ChannelDispatcherBase

ChannelDispatcher

Beispiele

Uri baseAddress = new Uri("http://localhost:8001/Simple");
ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);

serviceHost.AddServiceEndpoint(
    typeof(ICalculator),
    new WSHttpBinding(),
    "CalculatorServiceObject");

// Enable MEX.
ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
smb.HttpGetEnabled = true;
serviceHost.Description.Behaviors.Add(smb);

serviceHost.Open();

IChannelListener icl = serviceHost.ChannelDispatchers[0].Listener;
ChannelDispatcher dispatcher = new ChannelDispatcher(icl);
Console.WriteLine("servicehost has {0} ChannelDispatchers", serviceHost.ChannelDispatchers.Count);
ChannelDispatcherCollection dispatchers = serviceHost.ChannelDispatchers;

foreach (ChannelDispatcher disp in dispatchers)
{
    Console.WriteLine("Binding name: " + disp.BindingName);
}

Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();

// Close the ServiceHostBase to shutdown the service.
serviceHost.Close();

Dim baseAddress As New Uri("http://localhost:8001/Simple")
Dim serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)

serviceHost.AddServiceEndpoint(GetType(ICalculator), New WSHttpBinding(), "CalculatorServiceObject")

' Enable MEX.
Dim smb As New ServiceMetadataBehavior()
smb.HttpGetEnabled = True
serviceHost.Description.Behaviors.Add(smb)

serviceHost.Open()

Dim icl As IChannelListener = serviceHost.ChannelDispatchers(0).Listener
Dim dispatcher As New ChannelDispatcher(icl)
Console.WriteLine("servicehost has {0} ChannelDispatchers", serviceHost.ChannelDispatchers.Count)
Dim dispatchers As ChannelDispatcherCollection = serviceHost.ChannelDispatchers

For Each disp As ChannelDispatcher In dispatchers
    Console.WriteLine("Binding name: " & disp.BindingName)
Next disp

Console.WriteLine("The service is ready.")
Console.WriteLine("Press <ENTER> to terminate service.")
Console.WriteLine()
Console.ReadLine()

' Close the ServiceHostBase to shutdown the service.
serviceHost.Close()

Hinweise

Ein ChannelDispatcher-Objekt ordnet einen IChannelListener an einer bestimmten URI (als Abhör-URI bezeichnet) einer Instanz eines Dienstes zu. Jedes ServiceHost-Objekt kann über viele ChannelDispatcher-Objekte verfügen, die jeweils einem anderen Listener und einer anderen Abhör-URI für diesen Dienst zugeordnet sind.

Wenn eine Nachricht eingeht, fragt der ChannelDispatcher jedes der zugeordneten EndpointDispatcher-Objekte ab, ob der Endpunkt die Nachricht akzeptieren kann, und leitet die Nachricht an den Endpunkt weiter, der dies kann. Das EndpointDispatcher-Objekt ist verantwortlich für das Verarbeiten von Nachrichten von einem ChannelDispatcher, wenn die Zieladresse einer Nachricht mit der AddressFilter-Eigenschaft übereinstimmt und die Nachrichtenaktion mit der ContractFilter-Eigenschaft übereinstimmt.

Alle Eigenschaften, die die Lebensdauer und das Verhalten einer Kanalsitzung steuern, sind zur Überprüfung oder Änderung im ChannelDispatcher-Objekt verfügbar. Zusätzlich zum EndpointDispatcher enthalten diese benutzerdefinierte IChannelInitializer-Objekte, den IChannelListener, den ServiceHost und den zugeordneten InstanceContext.

Eigenschaften

DefaultCloseTimeout	Ruft das Standardzeitintervall für das Schließen des Kanalverteilers ab.
DefaultOpenTimeout	Ruft das Standardzeitintervall ab, das für das Öffnen des Kanalverteilers zulässig ist.
Endpoints	Ruft die Endpunktverteiler ab, die Nachrichten an die Kanalendpunkte weiterleiten.
ErrorHandlers	Ruft einen Satz von IErrorHandler-Objekten ab, die verwendet werden können, um benutzerdefinierte Fehlerverarbeitungsfunktionen für einen Endpunkt einzufügen.
Host	Ruft beim Überschreiben in einer abgeleiteten Klasse den Diensthost ab, der dem Kanalverteiler zugeordnet ist. (Geerbt von ChannelDispatcherBase)
IncludeExceptionDetailInFaults	Ruft einen Wert ab, der angibt, ob Einzelheiten zu einer Ausnahme in einen Fehler aufgenommen werden, bzw. ruft diesen Wert ab.
IsDisposed	Ruft einen Wert ab, mit dem angegeben wird, ob das Kommunikationsobjekt verworfen wurde. (Geerbt von CommunicationObject)
Listener	Ruft den Listener ab, der dem Kanalverteiler zugeordnet ist.
ManualAddressing	Ruft einen Wert ab oder legt ihn fest, der angibt, ob der Kanalverteiler Adressierungsheader zu Anforderungs-Antwort-Nachrichten hinzufügt.
MaxPendingReceives	Ruft die maximalen ausstehenden Nachrichten ab oder legt sie pro Kanal fest.
MaxTransactedBatchSize	Ruft die maximale Größe für einen transaktiven Batch ab oder legt diese fest.
MessageVersion	Ruft die Versionen der SOAP-Nachricht und WS-Addressing ab, die verwendet oder erwartet werden, bzw. legt diese fest.
ReceiveContextEnabled	Ruft ab oder legt fest, ob ReceiveContext aktiviert ist.
ReceiveSynchronously	Ruft einen Wert ab oder legt diesen fest, der angibt, ob der Verteiler synchrone Aufrufe verwendet, um Nachrichten aus Kanälen zu lesen.
SendAsynchronously	Ruft ab oder legt fest, ob Nachrichten asynchron gesendet werden.
State	Ruft einen Wert ab, der den aktuellen Zustand des Kommunikationsobjekts angibt. (Geerbt von CommunicationObject)
ThisLock	Ruft die gegenseitig exklusive Sperre ab, die die Klasseninstanz während eines Zustandsübergangs schützt. (Geerbt von CommunicationObject)

Methoden

Abort()	Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den Schließzustand übergeht. (Geerbt von CommunicationObject)
Attach(ServiceHostBase)	Fügt beim Überschreiben in einer abgeleiteten Klasse den Kanalverteiler an einen bestimmten Host an. (Geerbt von ChannelDispatcherBase)
BeginClose(AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Geerbt von CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt mit einem festgelegten Timeout zu schließen. (Geerbt von CommunicationObject)
BeginOpen(AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Geerbt von CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen. (Geerbt von CommunicationObject)
Close()	Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. (Geerbt von CommunicationObject)
Close(TimeSpan)	Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom aktuellen Zustand in den geschlossenen Zustand. (Geerbt von CommunicationObject)
CloseInput()	Hindert den Listener daran, neue Kanäle zu akzeptieren.
Detach(ServiceHostBase)	Trennt beim Überschreiben in einer abgeleiteten Klasse den Kanalverteiler von einem bestimmten Host. (Geerbt von ChannelDispatcherBase)
EndClose(IAsyncResult)	Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Geerbt von CommunicationObject)
EndOpen(IAsyncResult)	Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Geerbt von CommunicationObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Fault()	Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den Fehlerzustand übergeht. (Geerbt von CommunicationObject)
GetCommunicationObjectType()	Ruft den Typ des Kommunikationsobjekts ab. (Geerbt von CommunicationObject)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnAbort()	Bricht den dem Verteiler zugeordneten Listener ab.
OnBeginClose(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um einen Kanallistener für den Verteiler zu schließen, der innerhalb eines bestimmten Zeitraums abgeschlossen sein muss.
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um einen Kanallistener für den Verteiler zu öffnen, der innerhalb eines bestimmten Zeitraums abgeschlossen sein muss.
OnClose(TimeSpan)	Schließt den dem Verteiler zugeordneten Kanallistener innerhalb eines angegebenen Zeitraums.
OnCloseAsync(TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet.
OnClosed()	Stellt eine Ablaufverfolgung des Schließvorgangs des Endpunktverteilers bereit, der dem Kanalverteiler zugeordnet ist.
OnClosing()	Wird während des Übergangs eines Kommunikationsobjekts in den Schließzustand aufgerufen. (Geerbt von CommunicationObject)
OnEndClose(IAsyncResult)	Schließt einen asynchronen Vorgang zum Schließen eines Kanallisteners für den Verteiler ab.
OnEndOpen(IAsyncResult)	Schließt einen asynchronen Vorgang zum Öffnen eines Kanallisteners für den Verteiler ab.
OnFaulted()	Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines synchronen Fehlervorgangs der Übergang zum Fehlerzustand stattgefunden hat. (Geerbt von CommunicationObject)
OnOpen(TimeSpan)	Öffnet den Listener, der dem Kanalverteiler zugeordnet ist.
OnOpenAsync(TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet.
OnOpened()	Füllt die Filtertabelle auf und validiert diese, die zur Weiterleitung an die Endpunkte verwendet wird.
OnOpening()	Überprüft, ob der Kanalverteiler an einen Host angefügt ist.
Open()	Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand. (Geerbt von CommunicationObject)
Open(TimeSpan)	Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand. (Geerbt von CommunicationObject)
ThrowIfDisposed()	Löst eine Ausnahme aus, wenn das Kommunikationsobjekt verworfen wird. (Geerbt von CommunicationObject)
ThrowIfDisposedOrImmutable()	Löst eine Ausnahme aus, wenn das Kommunikationsobjekt der State-Eigenschaft nicht auf den Created-Zustand festgelegt wurde. (Geerbt von CommunicationObject)
ThrowIfDisposedOrNotOpen()	Löst eine Ausnahme aus, wenn sich das Kommunikationsobjekt nicht im Opened-Zustand befindet. (Geerbt von CommunicationObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

Closed	Tritt ein, sobald ein Kommunikationsobjekt in den geschlossenen Zustand übergeht. (Geerbt von CommunicationObject)
Closing	Tritt ein, sobald ein Kommunikationsobjekt in den Schließzustand übergeht. (Geerbt von CommunicationObject)
Faulted	Tritt ein, sobald ein Kommunikationsobjekt in den Fehlerzustand übergeht. (Geerbt von CommunicationObject)
Opened	Tritt ein, sobald ein Kommunikationsobjekt in den Geöffnet-Zustand übergeht. (Geerbt von CommunicationObject)
Opening	Tritt ein, sobald ein Kommunikationsobjekt in den Öffnungszustand übergeht. (Geerbt von CommunicationObject)

Explizite Schnittstellenimplementierungen

IAsyncCommunicationObject.CloseAsync(TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet. (Geerbt von CommunicationObject)
IAsyncCommunicationObject.OpenAsync(TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet. (Geerbt von CommunicationObject)

Erweiterungsmethoden

CloseHelperAsync(ICommunicationObject, TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet.
OpenHelperAsync(ICommunicationObject, TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet.
GetInternalCloseTimeout(CommunicationObject)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet.