Freigeben über


IChannel Schnittstelle

Definition

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
Implementiert

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:

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)

Gilt für: