IChannel Интерфейс

Определение

Пространство имен:

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Сборка:

System.ServiceModel.dll

Определяет базовый интерфейс, который должен быть реализован во всех объектах каналов. Требуется, чтобы в них был реализован интерфейс конечного автомата, совместно используемый всеми коммуникационными объектами, а также метод для извлечения объектов из стека каналов.

public interface class IChannel : System::ServiceModel::ICommunicationObject

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Производный

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Реализации

ICommunicationObject

Комментарии

Важно!

Вызов методов из классов, реализующих этот интерфейс, для ненадежных данных представляет угрозу безопасности. Вызывайте методы классов, реализующих этот интерфейс, только для надежных данных. Дополнительные сведения см. в разделе "Проверка всех входных данных".

Каналы должны соответствовать контракту конечного автомата, определенному в интерфейсе ICommunicationObject.

Интерфейс IChannel добавляет метод

GetProperty метод к интерфейсу ICommunicationObject . Этот метод предоставляет механизм извлечения свойств из стека каналов вне зависимости от их местоположения в этом стеке. Слово "property" (свойство) в имени метода относится к информации, принадлежащей одному из каналов в стеке. Тип CLR для этого свойства определяется как T. Этот метод извлечения данных также используется с фабриками каналов и прослушивателями каналов.

IChannel наследуется каждым из интерфейсов каналов, связанных с базовыми шаблонами обмена сообщениями:

• IInputChannel для получения сообщений.

• IOutputChannel для отправки сообщений.

• IRequestChannel для отправки запроса.

• IReplyChannel для отправки ответа.

• IDuplexChannel для двунаправленного обмена сообщениями.

Свойства

State

Возвращает текущее состояние объекта связи. (Унаследовано от ICommunicationObject)

Методы

Abort()	Вызывает мгновенный переход объекта связи из текущего состояния в состояние Closed. (Унаследовано от ICommunicationObject)
BeginClose(AsyncCallback, Object)	Начинает асинхронную операцию закрытия объекта связи. (Унаследовано от ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Начинает асинхронную операцию закрытия объекта связи с заданным временем ожидания. (Унаследовано от ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Начинает асинхронную операцию открытия объекта связи. (Унаследовано от ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Начинает асинхронную операцию открытия объекта связи в течение заданного интервала времени. (Унаследовано от ICommunicationObject)
Close()	Вызывает переход объекта связи из текущего состояния в состояние Closed. (Унаследовано от ICommunicationObject)
Close(TimeSpan)	Вызывает переход объекта связи из текущего состояния в состояние Closed. (Унаследовано от ICommunicationObject)
EndClose(IAsyncResult)	Завершает асинхронную операцию закрытия объекта связи. (Унаследовано от ICommunicationObject)
EndOpen(IAsyncResult)	Завершает асинхронную операцию открытия объекта связи. (Унаследовано от ICommunicationObject)
GetProperty<T>()	Возвращает запрошенный типизированный объект, если он имеется, из соответствующего уровня стека каналов.
Open()	Вызывает переход объекта связи из состояния Created в состояние Opened. (Унаследовано от ICommunicationObject)
Open(TimeSpan)	Вызывает переход объекта связи из состояния Created в состояние Opened в течение заданного интервала времени. (Унаследовано от ICommunicationObject)

События

Closed	Происходит после завершения перехода объекта связи из состояния Closing в состояние Closed. (Унаследовано от ICommunicationObject)
Closing	Происходит, если объект связи сначала переходит в состояние Closing. (Унаследовано от ICommunicationObject)
Faulted	Происходит, если объект связи сначала переходит в состояние Faulted. (Унаследовано от ICommunicationObject)
Opened	Происходит после завершения перехода объекта связи из состояния Opening в состояние Opened. (Унаследовано от ICommunicationObject)
Opening	Происходит, если объект связи сначала переходит в состояние Opening. (Унаследовано от ICommunicationObject)