IChannel Schnittstelle

Definition

Definiert die grundlegende Schnittstelle, die von allen Kanalobjekten implementiert werden muss.Defines the basic interface that all channel objects must implement. Voraussetzung hierfür ist die Implementierung der Statuscomputerschnittelle, die von allen Kommunikationsobjekten verwendet wird, sowie einer Methode zum Abrufen von Objekten aus dem Kanalstapel.It requires that they implement the state machine interface shared by all communication objects and that they implement a method to retrieve objects from the channel stack.

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.Calling methods from classes that implement this interface with untrusted data is a security risk. Rufen Sie die Methoden aus Klassen auf, die diese Schnittstelle nur mit vertrauenswürdigen Daten implementieren.Call the methods from classes that implement this interface only with trusted data. Weitere Informationen finden Sie unter Data Validation (Datenüberprüfung).For more information, see Data Validation.

Die Kanäle müssen den Vertrag eines Statuscomputers gemäß der ICommunicationObject-Schnittstelle erfüllen.Channels must satisfy the contract of a state machine as defined by the ICommunicationObject interface.

Mit der IChannel-SchnittstelleThe IChannel interface adds the

GetProperty Methode für die ICommunicationObject-Schnittstelle.GetProperty method to the ICommunicationObject interface. Diese Methode stellt einen Mechanismus zum Abrufen von Eigenschaften vom Kanalstapel unabhängig von der Position der Eigenschaften im Stapel bereit.This method provides a mechanism for retrieving properties from the channel stack regardless of where in the stack those properties live. Der Begriff "property" im Name der Methode bezieht sich auf die Information eines Kanals im Stapel.The term "property" in the method name refers to a piece of information that belongs to one of the channels in the stack. Der CLR-Typ für diese Eigenschaft wird von T bestimmt.The CLR type for that property is determined by T. Diese Abrufmethode wird auch für Kanalfactorys und Kanallistener verwendet.This method of retrieval is also used on channel factories and channel listeners.

IChannel wird von den Kanal Schnittstellen geerbt, die den grundlegenden Nachrichtenaustausch Mustern zugeordnet sind:IChannel is inherited by each of the channel interfaces associated with the basic message-exchange patterns:

Eigenschaften

State

Ruft den aktuellen Zustand des kommunikationsorientierten Objekts ab.Gets the current state of the communication-oriented object.

(Geerbt von ICommunicationObject)

Methoden

Abort()

Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den geschlossenen Zustand übergeht.Causes a communication object to transition immediately from its current state into the closed state.

(Geerbt von ICommunicationObject)
BeginClose(AsyncCallback, Object)

Startet einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts.Begins an asynchronous operation to close a communication object.

(Geerbt von ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt mit einem festgelegten Timeout zu schließen.Begins an asynchronous operation to close a communication object with a specified timeout.

(Geerbt von ICommunicationObject)
BeginOpen(AsyncCallback, Object)

Startet einen asynchronen Vorgang zum Öffnen eines Kommunikationsobjekts.Begins an asynchronous operation to open a communication object.

(Geerbt von ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Geerbt von ICommunicationObject)
Close()

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den Zustand „Geschlossen“ wechselt.Causes a communication object to transition from its current state into the closed state.

(Geerbt von ICommunicationObject)
Close(TimeSpan)

Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den Zustand „Geschlossen“ wechselt.Causes a communication object to transition from its current state into the closed state.

(Geerbt von ICommunicationObject)
EndClose(IAsyncResult)

Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen.Completes an asynchronous operation to close a communication object.

(Geerbt von ICommunicationObject)
EndOpen(IAsyncResult)

Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.Completes an asynchronous operation to open a communication object.

(Geerbt von ICommunicationObject)
GetProperty<T>()

Gibt ggf. ein angefordertes typisiertes Objekt von der entsprechenden Ebene im Kanalstapel zurück.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

Open()

Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state.

(Geerbt von ICommunicationObject)
Open(TimeSpan)

Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Geerbt von ICommunicationObject)

Ereignisse

Closed

Tritt ein, sobald der Übergang des Kommunikationsobjekts vom Schließen-Zustand in den Geschlossen-Zustand abgeschlossen ist.Occurs when the communication object completes its transition from the closing state into the closed state.

(Geerbt von ICommunicationObject)
Closing

Tritt ein, sobald das Kommunikationsobjekt den Schließzustand annimmt.Occurs when the communication object first enters the closing state.

(Geerbt von ICommunicationObject)
Faulted

Tritt ein, sobald das Kommunikationsobjekt den Fehlerzustand annimmt.Occurs when the communication object first enters the faulted state.

(Geerbt von ICommunicationObject)
Opened

Tritt ein, sobald der Übergang des Kommunikationsobjekts vom Öffnungszustand in den Geöffnet-Zustand abgeschlossen ist.Occurs when the communication object completes its transition from the opening state into the opened state.

(Geerbt von ICommunicationObject)
Opening

Tritt ein, sobald das Kommunikationsobjekt den Öffnungszustand annimmt.Occurs when the communication object first enters the opening state.

(Geerbt von ICommunicationObject)

Gilt für: