IClientChannel IClientChannel IClientChannel IClientChannel Interface

Определение

Определяет поведение исходящего запроса и каналов типа "запрос-ответ", используемых клиентскими приложениями.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)
Производный
Реализации

Комментарии

Интерфейс IClientChannel определяет операции, поддерживаемые всеми каналами, возвращенными вызовом метода ChannelFactory<TChannel>.CreateChannel.The IClientChannel interface defines the operations supported by all channels returned by a call to ChannelFactory<TChannel>.CreateChannel. Используйте методы и свойства IClientChannel для проверки и изменения исходящего типизированного канала.Use the IClientChannel methods and properties to inspect and modify the outbound typed channel. Средство служебной программы метаданных ServiceModel (Svcutil. exe) экспортирует как класс ClientBase<TChannel>, так и интерфейс контракта службы, создавая интерфейс контракта, который наследует от целевого контракта службы и IClientChannel, позволяя использовать расширенный контракт как прокси-сервер для службы и доступ к каналу клиента.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.

Дополнительные сведения см. в разделе архитектура клиента WCF.For more information, see WCF Client Architecture. Примеры его внешнего вида в создаваемых файлах кода клиента см. в разделе Основные сведения о созданном клиентском коде.For examples of its appearance in generated client code files, see Understanding Generated Client Code.

Свойства

AllowInitializationUI AllowInitializationUI AllowInitializationUI AllowInitializationUI

Возвращает или задает значение, указывающее, пытается интерфейс DisplayInitializationUI() вызвать объекты IInteractiveChannelInitializer в свойстве InteractiveChannelInitializers или создает исключение, если коллекция не пуста.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 AllowOutputBatching AllowOutputBatching AllowOutputBatching

Возвращает или задает значение, указывающее службе Windows Communication Foundation (WCF) сохранять набор сообщений перед передачей сообщений транспорту.Gets or sets a value that instructs Windows Communication Foundation (WCF) to store a set of messages before giving the messages to the transport.

(Inherited from IContextChannel)
DidInteractiveInitialization DidInteractiveInitialization DidInteractiveInitialization DidInteractiveInitialization

Возвращает значение, указывающее, был ли вызван пользовательский интерфейс для получения учетных данных.Gets a value indicating whether a call was done to a user interface to obtain credential information.

Extensions Extensions Extensions Extensions

Возвращает коллекцию объектов расширения для расширяемого объекта.Gets a collection of extension objects for this extensible object.

(Inherited from IExtensibleObject<T>)
InputSession InputSession InputSession InputSession

Возвращает входящий сеанс для канала.Gets the input session for the channel.

(Inherited from IContextChannel)
LocalAddress LocalAddress LocalAddress LocalAddress

Возвращает локальную конечную точку канала.Gets the local endpoint for the channel.

(Inherited from IContextChannel)
OperationTimeout OperationTimeout OperationTimeout OperationTimeout

Возвращает или задает период времени, в течение которого операция должна быть завершена, или выдается исключение.Gets or sets the time period within which an operation must complete or an exception is thrown.

(Inherited from IContextChannel)
OutputSession OutputSession OutputSession OutputSession

Возвращает выходной сеанс, связанный каналом, при его наличии.Gets the output session associated with the channel, if any.

(Inherited from IContextChannel)
RemoteAddress RemoteAddress RemoteAddress RemoteAddress

Возвращает удаленный адрес, связанный с каналом.Gets the remote address associated with the channel.

(Inherited from IContextChannel)
SessionId SessionId SessionId SessionId

Возвращает идентификатор текущего сеанса, при его наличии.Returns an identifier for the current session, if any.

(Inherited from IContextChannel)
State State State State

Возвращает текущее состояние объекта связи.Gets the current state of the communication-oriented object.

(Inherited from ICommunicationObject)
Via Via Via Via

Возвращает универсальный код ресурса (URI), содержащий адрес транспорта, по которому отправляются сообщения по каналу клиента.Gets the URI that contains the transport address to which messages are sent on the client channel.

Методы

Abort() Abort() Abort() Abort()

Вызывает мгновенный переход объекта связи из текущего состояния в состояние Closed.Causes a communication object to transition immediately from its current state into the closed state.

(Inherited from ICommunicationObject)
BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object)

Начинает асинхронную операцию закрытия объекта связи.Begins an asynchronous operation to close a communication object.

(Inherited from ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию закрытия объекта связи с заданным временем ожидания.Begins an asynchronous operation to close a communication object with a specified timeout.

(Inherited from ICommunicationObject)
BeginDisplayInitializationUI(AsyncCallback, Object) BeginDisplayInitializationUI(AsyncCallback, Object) BeginDisplayInitializationUI(AsyncCallback, Object) BeginDisplayInitializationUI(AsyncCallback, Object)

Асинхронный вызов для начала использования пользовательского интерфейса для получения учетных данных.An asynchronous call to begin using a user interface to obtain credential information.

BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи.Begins an asynchronous operation to open a communication object.

(Inherited from ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи в течение заданного интервала времени.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Inherited from ICommunicationObject)
Close() Close() Close() Close()

Вызывает переход объекта связи из текущего состояния в состояние Closed.Causes a communication object to transition from its current state into the closed state.

(Inherited from ICommunicationObject)
Close(TimeSpan) Close(TimeSpan) Close(TimeSpan) Close(TimeSpan)

Вызывает переход объекта связи из текущего состояния в состояние Closed.Causes a communication object to transition from its current state into the closed state.

(Inherited from ICommunicationObject)
DisplayInitializationUI() DisplayInitializationUI() DisplayInitializationUI() DisplayInitializationUI()

Вызов пользовательского интерфейса для получения учетных данных.A call to a user interface to obtain credential information.

Dispose() Dispose() Dispose() Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Inherited from IDisposable)
EndClose(IAsyncResult) EndClose(IAsyncResult) EndClose(IAsyncResult) EndClose(IAsyncResult)

Завершает асинхронную операцию закрытия объекта связи.Completes an asynchronous operation to close a communication object.

(Inherited from ICommunicationObject)
EndDisplayInitializationUI(IAsyncResult) EndDisplayInitializationUI(IAsyncResult) EndDisplayInitializationUI(IAsyncResult) EndDisplayInitializationUI(IAsyncResult)

Вызывается после завершения вызова BeginDisplayInitializationUI(AsyncCallback, Object).Called when the call to BeginDisplayInitializationUI(AsyncCallback, Object) has finished.

EndOpen(IAsyncResult) EndOpen(IAsyncResult) EndOpen(IAsyncResult) EndOpen(IAsyncResult)

Завершает асинхронную операцию открытия объекта связи.Completes an asynchronous operation to open a communication object.

(Inherited from ICommunicationObject)
GetProperty<T>() GetProperty<T>() GetProperty<T>() GetProperty<T>()

Возвращает запрошенный типизированный объект, если он имеется, из соответствующего уровня стека каналов.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

(Inherited from IChannel)
Open() Open() Open() Open()

Вызывает переход объекта связи из состояния Created в состояние Opened.Causes a communication object to transition from the created state into the opened state.

(Inherited from ICommunicationObject)
Open(TimeSpan) Open(TimeSpan) Open(TimeSpan) Open(TimeSpan)

Вызывает переход объекта связи из состояния Created в состояние Opened в течение заданного интервала времени.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Inherited from ICommunicationObject)

События

Closed Closed Closed Closed

Происходит после завершения перехода объекта связи из состояния Closing в состояние Closed.Occurs when the communication object completes its transition from the closing state into the closed state.

(Inherited from ICommunicationObject)
Closing Closing Closing Closing

Происходит, если объект связи сначала переходит в состояние Closing.Occurs when the communication object first enters the closing state.

(Inherited from ICommunicationObject)
Faulted Faulted Faulted Faulted

Происходит, если объект связи сначала переходит в состояние Faulted.Occurs when the communication object first enters the faulted state.

(Inherited from ICommunicationObject)
Opened Opened Opened Opened

Происходит после завершения перехода объекта связи из состояния Opening в состояние Opened.Occurs when the communication object completes its transition from the opening state into the opened state.

(Inherited from ICommunicationObject)
Opening Opening Opening Opening

Происходит, если объект связи сначала переходит в состояние Opening.Occurs when the communication object first enters the opening state.

(Inherited from ICommunicationObject)
UnknownMessageReceived UnknownMessageReceived UnknownMessageReceived UnknownMessageReceived

Это событие зарезервировано.This is a reserved event.

Применяется к