IClientChannel Schnittstelle

Definition

Definiert das Verhalten von Kanälen für ausgehende Anforderungen sowie das Verhalten von Anforderungs-/Antwortkanälen, die von Clientanwendungen verwendet werden.Defines the behavior of outbound request and request/reply channels used by client applications.

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 IContextChannel
    interface ICommunicationObject
    interface IDisposable
    interface IChannel
    interface IExtensibleObject<IContextChannel>
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 an ChannelFactory<TChannel>.CreateChannel zurückgegeben werden.The IClientChannel interface defines the operations supported by all channels returned by a call to ChannelFactory<TChannel>.CreateChannel. Verwenden Sie die IClientChannel-Methoden und -Eigenschaften, um den ausgehenden typisierten Kanal zu überprüfen und zu ändern.Use the IClientChannel methods and properties to inspect and modify the outbound typed channel. Das Service Model Metadata Utility-Tool (Svcutil. exe) exportiert sowohl eine ClientBase<TChannel> Klasse als auch eine Dienstvertragschnittstelle, indem eine Vertrags Schnittstelle erstellt wird, die sowohl vom Ziel Dienstvertrag als auch von der IClientChannelerbt, sodass Sie den erweiterten Vertrag als Proxy für den Dienst und für den Zugriff auf den Clientchannel verwenden können.The ServiceModel Metadata Utility Tool (Svcutil.exe) exports both a ClientBase<TChannel> class and a service contract interface by creating a contract interface that inherits from both the target service contract and IClientChannel, enabling you to use the extended contract as both the proxy to the service and to access the client channel.

Weitere Informationen finden Sie unter WCF-Client Architektur.For more information, see WCF Client Architecture. Beispiele für seine Darstellung in generierten Client Code Dateien finden Sie Untergrund Legendes zum generierten Client Code.For examples of its appearance in generated client code files, see Understanding Generated Client Code.

Eigenschaften

AllowInitializationUI

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob DisplayInitializationUI() versucht, die IInteractiveChannelInitializer-Objekte in der InteractiveChannelInitializers-Eigenschaft aufzurufen, oder der ausgelöst wird, wenn diese Sammlung nicht leer ist.Gets or sets a value indicating whether DisplayInitializationUI() attempts to call the IInteractiveChannelInitializer objects in the InteractiveChannelInitializers property or throws if that collection is not empty.

AllowOutputBatching

Ruft einen Wert ab oder legt ihn fest, der Windows Communication Foundation (WCF) anweist, einen Nachrichtensatz zu speichern, bevor die Nachrichten zum Transport weitergeleitet werden.Gets or sets a value that instructs Windows Communication Foundation (WCF) to store a set of messages before giving the messages to the transport.

(Geerbt von IContextChannel)
DidInteractiveInitialization

Ruft einen Wert ab, der angibt, ob ein Aufruf bei einer Benutzeroberfläche erfolgte, um Anmeldeinformationen zu erhalten.Gets a value indicating whether a call was done to a user interface to obtain credential information.

Extensions

Ruft eine Auflistung der Erweiterungsobjekte für dieses erweiterbare Objekt ab.Gets a collection of extension objects for this extensible object.

(Geerbt von IExtensibleObject<T>)
InputSession

Ruft die Eingabesitzung für den Kanal ab.Gets the input session for the channel.

(Geerbt von IContextChannel)
LocalAddress

Ruft den lokalen Endpunkt für den Kanal ab.Gets the local endpoint for the channel.

(Geerbt von IContextChannel)
OperationTimeout

Ruft den Zeitraum ab oder legt ihn fest, innerhalb dessen ein Vorgang abgeschlossen werden muss oder eine Ausnahme ausgelöst wird.Gets or sets the time period within which an operation must complete or an exception is thrown.

(Geerbt von IContextChannel)
OutputSession

Ruft ggf. die dem Kanal zugeordnete Ausgabesitzung ab.Gets the output session associated with the channel, if any.

(Geerbt von IContextChannel)
RemoteAddress

Ruft die dem Kanal zugeordnete Remote-Adresse ab.Gets the remote address associated with the channel.

(Geerbt von IContextChannel)
SessionId

Gibt ggf. für die aktuelle Sitzung einen Bezeichner zurück.Returns an identifier for the current session, if any.

(Geerbt von IContextChannel)
State

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

(Geerbt von ICommunicationObject)
Via

Ruft die URI ab, die die Transportadresse enthält, an die Nachrichten im Clientkanal gesendet werden.Gets the URI that contains the transport address to which messages are sent on the client channel.

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)
BeginDisplayInitializationUI(AsyncCallback, Object)

Ein asynchroner Aufruf, um mit der Verwendung einer Benutzeroberfläche zur Abfrage der Anmeldeinformationen zu beginnen.An asynchronous call to begin using a user interface to obtain credential information.

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)
DisplayInitializationUI()

Ein Aufruf bei einer Benutzeroberfläche, um Anmeldeinformationen zu erhalten.A call to a user interface to obtain credential information.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Geerbt von IDisposable)
EndClose(IAsyncResult)

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

(Geerbt von ICommunicationObject)
EndDisplayInitializationUI(IAsyncResult)

Wird aufgerufen, wenn der Aufruf von BeginDisplayInitializationUI(AsyncCallback, Object) beendet wurde.Called when the call to BeginDisplayInitializationUI(AsyncCallback, Object) has finished.

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.

(Geerbt von IChannel)
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)
UnknownMessageReceived

Dies ist ein reserviertes Ereignis.This is a reserved event.

Gilt für: