IChannel Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет базовый интерфейс, который должны реализовывать все объекты канала. Он требует, чтобы они реализовали интерфейс компьютера состояния, общий для всех объектов связи, и что они реализуют метод для извлечения объектов из стека каналов.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Производный
- Реализации
Комментарии
Important
Вызов методов из классов, реализующих этот интерфейс с ненадежными данными, является угрозой безопасности. Вызовите методы из классов, реализующих этот интерфейс только с доверенными данными. Дополнительные сведения см. в разделе Проверка всех входных данных.
Каналы должны удовлетворять контракту компьютера состояния, определенного интерфейсом ICommunicationObject .
Интерфейс IChannel добавляет
GetProperty метод интерфейса ICommunicationObject . Этот метод предоставляет механизм получения свойств из стека каналов независимо от того, где в стеке эти свойства живут. Термин "свойство" в имени метода ссылается на часть информации, которая принадлежит одному из каналов в стеке. Тип СРЕДЫ CLR для этого свойства определяется T. Этот метод извлечения также используется в фабриках каналов и прослушивателях каналов.
IChannel наследуется каждым из интерфейсов канала, связанных с основными шаблонами обмена сообщениями:
IInputChannel для получения сообщений.
IOutputChannel для отправки сообщений.
IRequestChannel для отправки запроса.
IReplyChannel для отправки ответа.
IDuplexChannel для двунаправленного обмена сообщениями.
Свойства
| Имя | Описание |
|---|---|
| State |
Возвращает текущее состояние объекта, ориентированного на обмен данными. (Унаследовано от ICommunicationObject) |
Методы
| Имя | Описание |
|---|---|
| Abort() |
Вызывает немедленное переход объекта связи из текущего состояния в закрытое состояние. (Унаследовано от ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Начинает асинхронную операцию закрытия объекта связи. (Унаследовано от ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Начинает асинхронную операцию закрытия объекта связи с заданным временем ожидания. (Унаследовано от ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Начинает асинхронную операцию для открытия объекта связи. (Унаследовано от ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Начинает асинхронную операцию открытия объекта связи в течение указанного интервала времени. (Унаследовано от ICommunicationObject) |
| Close() |
Вызывает переход объекта связи из текущего состояния в закрытое состояние. (Унаследовано от ICommunicationObject) |
| Close(TimeSpan) |
Вызывает переход объекта связи из текущего состояния в закрытое состояние. (Унаследовано от ICommunicationObject) |
| EndClose(IAsyncResult) |
Завершает асинхронную операцию закрытия объекта связи. (Унаследовано от ICommunicationObject) |
| EndOpen(IAsyncResult) |
Завершает асинхронную операцию для открытия объекта связи. (Унаследовано от ICommunicationObject) |
| GetProperty<T>() |
Возвращает типизированный объект, запрошенный при наличии, из соответствующего слоя в стеке каналов. |
| Open() |
Вызывает переход объекта связи из созданного состояния в открытое состояние. (Унаследовано от ICommunicationObject) |
| Open(TimeSpan) |
Вызывает переход объекта связи из созданного состояния в открытое состояние в течение указанного интервала времени. (Унаследовано от ICommunicationObject) |
События
| Имя | Описание |
|---|---|
| Closed |
Происходит при завершении перехода объекта связи из закрывающего состояния в закрытое состояние. (Унаследовано от ICommunicationObject) |
| Closing |
Происходит при первом входе объекта связи в состояние закрытия. (Унаследовано от ICommunicationObject) |
| Faulted |
Происходит при первом входе объекта связи в состояние сбоя. (Унаследовано от ICommunicationObject) |
| Opened |
Происходит, когда объект связи завершает переход с открывающего состояния в открытое состояние. (Унаследовано от ICommunicationObject) |
| Opening |
Происходит при первом входе объекта связи в состояние открытия. (Унаследовано от ICommunicationObject) |
