IReplyChannel Schnittstelle

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Definiert die Schnittstelle, die ein Kanal implementieren muss, um auf der Empfangsseite einer Anforderung-Antwort-Kommunikation zwischen Messaging-Endpunkten zu stehen.

public interface class IReplyChannel : System::ServiceModel::Channels::IChannel

public interface IReplyChannel : System.ServiceModel.Channels.IChannel

type IReplyChannel = interface
    interface IChannel
    interface ICommunicationObject

Public Interface IReplyChannel
Implements IChannel

Abgeleitet

System.ServiceModel.Channels.IReplySessionChannel

Implementiert

IChannel ICommunicationObject

Hinweise

Wichtig

Das Aufrufen von Methoden aus Klassen, die diese Schnittstelle mit nicht vertrauenswürdigen Daten implementieren, stellt ein Sicherheitsrisiko dar. Rufen Sie die Methoden aus Klassen auf, die diese Schnittstelle nur mit vertrauenswürdigen Daten implementieren. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Die IReplyChannel-Schnittstelle enthält synchrone und asynchrone Varianten einer ReceiveRequest-Methodenrückgabe und einen RequestContext, der verwendet werden kann, um Antworten auf empfangene Anfragen zu erstellen.

Der Vertrag enthält synchrone und asynchrone Varianten von Empfangs-, Empfangsversuchs- und Warten-auf-Nachricht-Funktionen.

Ein IReplyChannel ist nicht notwendigerweise an einen einzelnen Absender gebunden. Andere Kanäle und Kanalschnittstellen bieten Beziehungen zwischen dem Absende- und Antwortkanal, aber der Basisvertrag macht diese Einschränkung nicht.

Das Pullmodell wird mit einem IReplyChannel verwendet, um Nachrichten zu empfangen. Dieses Modell besteht aus dem Aufruf von ReceiveRequest (oder eine der Varianten) und daraufhin aus dem Warten auf die Ankunft der Nachricht.

Eigenschaften

LocalAddress	Ruft die Adresse ab, auf der dieser Antwortkanal Nachrichten empfängt.
State	Ruft den aktuellen Zustand des kommunikationsorientierten Objekts ab. (Geerbt von ICommunicationObject)

Methoden

Abort()	Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den geschlossenen Zustand übergeht. (Geerbt von ICommunicationObject)
BeginClose(AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Geerbt von ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt mit einem festgelegten Timeout zu schließen. (Geerbt von ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Geerbt von ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen. (Geerbt von ICommunicationObject)
BeginReceiveRequest(AsyncCallback, Object)	Startet einen asynchronen Vorgang, mit einem Standard-Timeout eine verfügbare Anforderung zu empfangen.
BeginReceiveRequest(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um eine verfügbare Anforderung mit einem angegebenen Timeout zu empfangen.
BeginTryReceiveRequest(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Vorgang, um eine Anforderungsnachricht zu empfangen, die über einen angegebenen Timeout und ein zugeordnetes Statusobjekt verfügt.
BeginWaitForRequest(TimeSpan, AsyncCallback, Object)	Startet einen asynchronen Anforderungsvorgang, der über ein angegebenes Timeout und ein ihm zugeordnetes Zustandsobjekt verfügt.
Close()	Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. (Geerbt von ICommunicationObject)
Close(TimeSpan)	Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. (Geerbt von ICommunicationObject)
EndClose(IAsyncResult)	Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Geerbt von ICommunicationObject)
EndOpen(IAsyncResult)	Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Geerbt von ICommunicationObject)
EndReceiveRequest(IAsyncResult)	Beendet einen asynchronen Vorgang, um eine verfügbare Anforderung zu empfangen.
EndTryReceiveRequest(IAsyncResult, RequestContext)	Schließt den angegebenen asynchronen Vorgang ab, um eine Anforderungsnachricht zu empfangen.
EndWaitForRequest(IAsyncResult)	Schließt den angegebenen asynchronen Vorgang des Wartens auf eine Anforderungsnachricht ab.
GetProperty<T>()	Gibt ggf. ein angefordertes typisiertes Objekt von der entsprechenden Ebene im Kanalstapel zurück. (Geerbt von IChannel)
Open()	Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand. (Geerbt von ICommunicationObject)
Open(TimeSpan)	Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand. (Geerbt von ICommunicationObject)
ReceiveRequest()	Gibt, wenn verfügbar, den Kontext der empfangenen Anforderung zurück. Wenn kein Kontext verfügbar ist, wird gewartet, bis einer zur Verfügung steht.
ReceiveRequest(TimeSpan)	Gibt, wenn verfügbar, den Kontext der empfangenen Anforderung zurück. Wenn kein Kontext verfügbar ist, wird gewartet, bis einer zur Verfügung steht.
TryReceiveRequest(TimeSpan, RequestContext)	Gibt einen Wert zurück, der angibt, ob eine Anforderung vor Ablauf eines angegebenen Zeitintervalls empfangen wird.
WaitForRequest(TimeSpan)	Gibt einen Wert zurück, der angibt, ob eine Anforderungsnachricht vor Ablauf eines angegebenen Zeitintervalls empfangen wird.

Ereignisse

Closed	Tritt ein, sobald der Übergang des Kommunikationsobjekts vom Schließen-Zustand in den Geschlossen-Zustand abgeschlossen ist. (Geerbt von ICommunicationObject)
Closing	Tritt ein, sobald das Kommunikationsobjekt den Schließzustand annimmt. (Geerbt von ICommunicationObject)
Faulted	Tritt ein, sobald das Kommunikationsobjekt den Fehlerzustand annimmt. (Geerbt von ICommunicationObject)
Opened	Tritt ein, sobald der Übergang des Kommunikationsobjekts vom Öffnungszustand in den Geöffnet-Zustand abgeschlossen ist. (Geerbt von ICommunicationObject)
Opening	Tritt ein, sobald das Kommunikationsobjekt den Öffnungszustand annimmt. (Geerbt von ICommunicationObject)