IChannel Schnittstelle
Definition
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.
Definiert die grundlegende Schnittstelle, die alle Kanalobjekte implementieren müssen. Es erfordert, dass sie die zustandsautomatschnittstelle implementieren, die von allen Kommunikationsobjekten gemeinsam verwendet wird und dass sie eine Methode zum Abrufen von Objekten aus dem Kanalstapel implementieren.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Abgeleitet
- Implementiert
Hinweise
Important
Das Aufrufen von Methoden aus Klassen, die diese Schnittstelle mit nicht vertrauenswürdigen Daten implementieren, ist ein Sicherheitsrisiko. 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.
Kanäle müssen den Vertrag eines Zustandsautomaten erfüllen, wie von der ICommunicationObject Schnittstelle definiert.
Die IChannel Schnittstelle fügt die
GetProperty -Methode für die ICommunicationObject Schnittstelle. Diese Methode stellt einen Mechanismus zum Abrufen von Eigenschaften aus dem Kanalstapel bereit, unabhängig davon, wo sich diese Eigenschaften befinden. Der Begriff "Eigenschaft" im Methodennamen bezieht sich auf einen Teil der Informationen, die zu einem der Kanäle im Stapel gehören. Der CLR-Typ für diese Eigenschaft wird durch Tbestimmt. Diese Methode des Abrufs wird auch für Kanalfabriken und Kanallistener verwendet.
IChannel wird von den einzelnen Kanalschnittstellen geerbt, die den grundlegenden Nachrichtenaustauschmustern zugeordnet sind:
IInputChannel zum Empfangen von Nachrichten.
IOutputChannel zum Senden von Nachrichten.
IRequestChannel zum Senden einer Anforderung.
IReplyChannel zum Senden einer Antwort.
IDuplexChannel für bidirektionale Nachrichten.
Eigenschaften
| Name | Beschreibung |
|---|---|
| State |
Ruft den aktuellen Status des kommunikationsorientierten Objekts ab. (Geerbt von ICommunicationObject) |
Methoden
| Name | Beschreibung |
|---|---|
| Abort() |
Bewirkt, dass ein Kommunikationsobjekt sofort vom aktuellen Zustand in den geschlossenen Zustand wechselt. (Geerbt von ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Startet einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts. (Geerbt von ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Startet einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts mit einem angegebenen Timeout. (Geerbt von ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Startet einen asynchronen Vorgang zum Öffnen eines Kommunikationsobjekts. (Geerbt von ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines bestimmten Zeitintervalls zu öffnen. (Geerbt von ICommunicationObject) |
| Close() |
Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand wechselt. (Geerbt von ICommunicationObject) |
| Close(TimeSpan) |
Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand wechselt. (Geerbt von ICommunicationObject) |
| EndClose(IAsyncResult) |
Schließt einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts ab. (Geerbt von ICommunicationObject) |
| EndOpen(IAsyncResult) |
Schließt einen asynchronen Vorgang zum Öffnen eines Kommunikationsobjekts ab. (Geerbt von ICommunicationObject) |
| GetProperty<T>() |
Gibt ein typiertes Objekt zurück, das ( falls vorhanden) aus der entsprechenden Ebene im Kanalstapel angefordert wird. |
| Open() |
Bewirkt, dass ein Kommunikationsobjekt vom erstellten Zustand in den geöffneten Zustand wechselt. (Geerbt von ICommunicationObject) |
| Open(TimeSpan) |
Bewirkt, dass ein Kommunikationsobjekt innerhalb eines bestimmten Zeitintervalls vom erstellten Zustand in den geöffneten Zustand wechselt. (Geerbt von ICommunicationObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Closed |
Tritt auf, wenn das Kommunikationsobjekt seinen Übergang vom Abschlusszustand in den geschlossenen Zustand abschließt. (Geerbt von ICommunicationObject) |
| Closing |
Tritt auf, wenn das Kommunikationsobjekt zuerst in den Schließen-Zustand wechselt. (Geerbt von ICommunicationObject) |
| Faulted |
Tritt auf, wenn das Kommunikationsobjekt zuerst in den fehlerhaften Zustand wechselt. (Geerbt von ICommunicationObject) |
| Opened |
Tritt auf, wenn das Kommunikationsobjekt seinen Übergang vom Öffnungszustand in den geöffneten Zustand abschließt. (Geerbt von ICommunicationObject) |
| Opening |
Tritt auf, wenn das Kommunikationsobjekt zuerst in den Öffnungszustand wechselt. (Geerbt von ICommunicationObject) |
