IClientChannel Интерфейс

Определение

Определяет поведение исходящего запроса и каналов типа "запрос-ответ", используемых клиентскими приложениями.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 IDisposable
    interface IChannel
    interface ICommunicationObject
    interface IContextChannel
    interface IExtensibleObject<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
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

Возвращает или задает значение, указывающее, пытается интерфейс 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

Возвращает или задает значение, указывающее службе 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.

(Унаследовано от IContextChannel)
DidInteractiveInitialization

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

Extensions

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

(Унаследовано от IExtensibleObject<T>)
InputSession

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

(Унаследовано от IContextChannel)
LocalAddress

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

(Унаследовано от IContextChannel)
OperationTimeout

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

(Унаследовано от IContextChannel)
OutputSession

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

(Унаследовано от IContextChannel)
RemoteAddress

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

(Унаследовано от IContextChannel)
SessionId

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

(Унаследовано от IContextChannel)
State

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

(Унаследовано от ICommunicationObject)
Via

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

Методы

Abort()

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

(Унаследовано от ICommunicationObject)
BeginClose(AsyncCallback, Object)

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

(Унаследовано от ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

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

(Унаследовано от ICommunicationObject)
BeginDisplayInitializationUI(AsyncCallback, Object)

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

BeginOpen(AsyncCallback, Object)

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

(Унаследовано от ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

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

(Унаследовано от ICommunicationObject)
Close()

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

(Унаследовано от ICommunicationObject)
Close(TimeSpan)

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

(Унаследовано от ICommunicationObject)
DisplayInitializationUI()

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

Dispose()

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

(Унаследовано от IDisposable)
EndClose(IAsyncResult)

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

(Унаследовано от ICommunicationObject)
EndDisplayInitializationUI(IAsyncResult)

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

EndOpen(IAsyncResult)

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

(Унаследовано от ICommunicationObject)
GetProperty<T>()

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

(Унаследовано от IChannel)
Open()

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

(Унаследовано от ICommunicationObject)
Open(TimeSpan)

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

(Унаследовано от ICommunicationObject)

События

Closed

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

(Унаследовано от ICommunicationObject)
Closing

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

(Унаследовано от ICommunicationObject)
Faulted

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

(Унаследовано от ICommunicationObject)
Opened

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

(Унаследовано от ICommunicationObject)
Opening

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

(Унаследовано от ICommunicationObject)
UnknownMessageReceived

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

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