IChannel Schnittstelle

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Definiert die grundlegende Schnittstelle, die von allen Kanalobjekten implementiert werden muss. Voraussetzung hierfür ist die Implementierung der Statuscomputerschnittelle, die von allen Kommunikationsobjekten verwendet wird, sowie einer Methode zum Abrufen von Objekten aus dem Kanalstapel.

public interface class IChannel : System::ServiceModel::ICommunicationObject

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Abgeleitet

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Implementiert

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 Kanäle müssen den Vertrag eines Statuscomputers gemäß der ICommunicationObject-Schnittstelle erfüllen.

Mit der IChannel-Schnittstelle

GetProperty Methode für die ICommunicationObject Schnittstelle. Diese Methode stellt einen Mechanismus zum Abrufen von Eigenschaften vom Kanalstapel unabhängig von der Position der Eigenschaften im Stapel bereit. Der Begriff "property" im Name der Methode bezieht sich auf die Information eines Kanals im Stapel. Der CLR-Typ für diese Eigenschaft wird von T bestimmt. Diese Abrufmethode wird auch für Kanalfactorys und Kanallistener verwendet.

IChannel wird von den einzelnen Kanalschnittstellen geerbt, die den grundlegenden Nachrichtenaustauschmustern zugeordnet sind:

• IInputChannel für das Empfangen von Nachrichten.

• IOutputChannel zum Senden von Nachrichten.

• IRequestChannel zum Senden einer Anforderung.

• IReplyChannel für das Senden einer Antwort.

• IDuplexChannel für bidirektionale Nachrichten.

Eigenschaften

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)
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)
GetProperty<T>()	Gibt ggf. ein angefordertes typisiertes Objekt von der entsprechenden Ebene im Kanalstapel zurück.
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)

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)