ChannelDispatcher Klasse

Referenz

Definition

Namespace:: System.ServiceModel.Dispatcher

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Paket:: System.ServiceModel.Primitives v6.0.0

Paket:: System.ServiceModel.Primitives v6.2.0

Quelle:: ChannelDispatcher.cs

Quelle:: ChannelDispatcher.cs

Quelle:: ChannelDispatcher.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

Konstruktoren

ChannelDispatcher(IChannelListener)	Initialisiert eine neue Instanz der ChannelDispatcher-Klasse.
ChannelDispatcher(IChannelListener, String)	Initialisiert eine neue Instanz der ChannelDispatcher-Klasse.
ChannelDispatcher(IChannelListener, String, IDefaultCommunicationTimeouts)	Initialisiert eine neue Instanz der ChannelDispatcher-Klasse.

Eigenschaften

AsynchronousTransactedAcceptEnabled	Ruft einen Wert ab, der angibt, ob die transaktiven Accept-Methodenaufrufe des Listeners asynchron sind.
BindingName	Ruft den Namen der Bindung ab, die zur Konfiguration des Diensts verwendet wird.
ChannelInitializers	Ruft einen Satz von IChannelInitializer-Objekten ab, die Sie verwenden können, um den Zustand des Kanals bei der ersten Erstellung zu überprüfen und hinzuzufügen.
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 den Host für den Dienst ab, der dem Verteiler zugeordnet ist.
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)
IsTransactedAccept	Ruft einen Wert ab, der angibt, ob die Accept-Methodenaufrufe des Listeners im Rahmen einer Transaktion erfolgen.
IsTransactedReceive	Ruft einen Wert ab, der angibt, ob die Receive-Methodenaufrufe des Listeners im Rahmen einer Transaktion erfolgen.
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.
ServiceThrottle	Ruft die Dienstdrosselung für den Dienst ab, der dem Kanalverteiler zugeordnet ist, bzw. legt sie fest.
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)
TransactionIsolationLevel	Ruft die Standardisolationsstufe für Transaktionen ab bzw. legt diese fest.
TransactionTimeout	Ruft einen Wert ab, der das Standardtimeout für neue Transaktionen angibt, die der Verteiler für den Dienst erstellt, bzw. legt diesen fest.

Methoden

Abort()	Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den Schließzustand übergeht. (Geerbt von CommunicationObject)
Attach(ServiceHostBase)	Fügt den Kanalverteiler an den Host an.
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 den Diensthost vom Kanalverteiler.
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.
OnCloseAsync(TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet. (Geerbt von CommunicationObject)
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.
OnOpenAsync(TimeSpan)	Eine Komponente, die Kanäle akzeptiert und diese einem Dienst zuordnet. (Geerbt von CommunicationObject)
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.

Gilt für: