IChannel Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет базовый интерфейс, который должен быть реализован во всех объектах каналов. Требуется, чтобы в них был реализован интерфейс конечного автомата, совместно используемый всеми коммуникационными объектами, а также метод для извлечения объектов из стека каналов.
public interface class IChannel : System::ServiceModel::ICommunicationObject
public interface IChannel : System.ServiceModel.ICommunicationObject
type IChannel = interface
interface ICommunicationObject
Public Interface IChannel
Implements 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) |