IClientChannel 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 das Verhalten von ausgehenden Anforderungs- und Antwortkanälen, die von Clientanwendungen verwendet werden.
public interface class IClientChannel : IDisposable, System::ServiceModel::IContextChannel, System::ServiceModel::IExtensibleObject<System::ServiceModel::IContextChannel ^>
public interface IClientChannel : IDisposable, System.ServiceModel.IContextChannel, System.ServiceModel.IExtensibleObject<System.ServiceModel.IContextChannel>
type IClientChannel = interface
interface IDisposable
interface IContextChannel
interface IChannel
interface ICommunicationObject
interface IExtensibleObject<IContextChannel>
type IClientChannel = interface
interface IContextChannel
interface IChannel
interface ICommunicationObject
interface IExtensibleObject<IContextChannel>
interface IDisposable
Public Interface IClientChannel
Implements IContextChannel, IDisposable, IExtensibleObject(Of IContextChannel)
- Abgeleitet
- Implementiert
Hinweise
Die IClientChannel Schnittstelle definiert die Vorgänge, die von allen Kanälen unterstützt werden, die von einem Aufruf zurückgegeben ChannelFactory<TChannel>.CreateChannelwerden. Verwenden Sie die IClientChannel Methoden und Eigenschaften, um den ausgehenden typierten Kanal zu prüfen und zu ändern. Das ServiceModel Metadata Utility Tool (Svcutil.exe) exportiert sowohl eine ClientBase<TChannel> Klassen- als auch eine Dienstvertragsschnittstelle, indem eine Vertragsschnittstelle erstellt wird, die sowohl vom Zieldienstvertrag IClientChannelerbt als auch, sodass Sie den erweiterten Vertrag sowohl als Proxy für den Dienst als auch für den Zugriff auf den Clientkanal verwenden können.
Weitere Informationen finden Sie unter WCF-Clientarchitektur. Beispiele für die Darstellung in generierten Clientcodedateien finden Sie unter Understanding Generated Client Code.
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllowInitializationUI |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob DisplayInitializationUI() versucht wird, die IInteractiveChannelInitializer Objekte in der InteractiveChannelInitializers Eigenschaft aufzurufen oder ausgelöst wird, wenn diese Auflistung nicht leer ist. |
| AllowOutputBatching |
Dient zum Abrufen oder Festlegen eines Werts, der Windows Communication Foundation (WCF) anweist, eine Reihe von Nachrichten zu speichern, bevor die Nachrichten dem Transport zugewiesen werden. (Geerbt von IContextChannel) |
| DidInteractiveInitialization |
Ruft einen Wert ab, der angibt, ob ein Aufruf an eine Benutzeroberfläche durchgeführt wurde, um Anmeldeinformationen abzurufen. |
| Extensions |
Ruft eine Auflistung von Erweiterungsobjekten für dieses erweiterbare Objekt ab. (Geerbt von IExtensibleObject<T>) |
| InputSession |
Ruft die Eingabesitzung für den Kanal ab. (Geerbt von IContextChannel) |
| LocalAddress |
Ruft den lokalen Endpunkt für den Kanal ab. (Geerbt von IContextChannel) |
| OperationTimeout |
Ruft den Zeitraum ab, in dem ein Vorgang abgeschlossen werden muss oder eine Ausnahme ausgelöst wird, oder legt ihn fest. (Geerbt von IContextChannel) |
| OutputSession |
Ruft die Ausgabesitzung ab, die dem Kanal zugeordnet ist, falls vorhanden. (Geerbt von IContextChannel) |
| RemoteAddress |
Ruft die Remoteadresse ab, die dem Kanal zugeordnet ist. (Geerbt von IContextChannel) |
| SessionId |
Gibt ggf. einen Bezeichner für die aktuelle Sitzung zurück. (Geerbt von IContextChannel) |
| State |
Ruft den aktuellen Status des kommunikationsorientierten Objekts ab. (Geerbt von ICommunicationObject) |
| Via |
Ruft den URI ab, der die Transportadresse enthält, an die Nachrichten im Clientkanal gesendet werden. |
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) |
| BeginDisplayInitializationUI(AsyncCallback, Object) |
Ein asynchroner Aufruf, um mit der Verwendung einer Benutzeroberfläche zu beginnen, um Anmeldeinformationen abzurufen. |
| 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) |
| DisplayInitializationUI() |
Ein Aufruf einer Benutzeroberfläche zum Abrufen von Anmeldeinformationen. |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (Geerbt von IDisposable) |
| EndClose(IAsyncResult) |
Schließt einen asynchronen Vorgang zum Schließen eines Kommunikationsobjekts ab. (Geerbt von ICommunicationObject) |
| EndDisplayInitializationUI(IAsyncResult) |
Wird aufgerufen, wenn der Anruf BeginDisplayInitializationUI(AsyncCallback, Object) beendet wurde. |
| 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. (Geerbt von IChannel) |
| 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) |
| UnknownMessageReceived |
Dies ist ein reserviertes Ereignis. |