IChannel Интерфейс

Определение

Определяет базовый интерфейс, который должен быть реализован во всех объектах каналов.Defines the basic interface that all channel objects must implement. Требуется, чтобы в них был реализован интерфейс конечного автомата, совместно используемый всеми коммуникационными объектами, а также метод для извлечения объектов из стека каналов.It requires that they implement the state machine interface shared by all communication objects and that they implement a method to retrieve objects from the channel stack.

public interface class IChannel : System::ServiceModel::ICommunicationObject
public interface IChannel : System.ServiceModel.ICommunicationObject
type IChannel = interface
    interface ICommunicationObject
Public Interface IChannel
Implements ICommunicationObject
Производный
Реализации

Комментарии

Важно!

Вызов методов из классов, реализующих этот интерфейс, для ненадежных данных представляет угрозу безопасности.Calling methods from classes that implement this interface with untrusted data is a security risk. Вызывайте методы классов, реализующих этот интерфейс, только для надежных данных.Call the methods from classes that implement this interface only with trusted data. Дополнительные сведения: Data Validation (Проверка данных).For more information, see Data Validation.

Каналы должны соответствовать контракту конечного автомата, определенному в интерфейсе ICommunicationObject.Channels must satisfy the contract of a state machine as defined by the ICommunicationObject interface.

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

GetProperty метод в ICommunicationObject интерфейс.GetProperty method to the ICommunicationObject interface. Этот метод предоставляет механизм извлечения свойств из стека каналов вне зависимости от их местоположения в этом стеке.This method provides a mechanism for retrieving properties from the channel stack regardless of where in the stack those properties live. Слово "property" (свойство) в имени метода относится к информации, принадлежащей одному из каналов в стеке.The term "property" in the method name refers to a piece of information that belongs to one of the channels in the stack. Тип CLR для этого свойства определяется как T.The CLR type for that property is determined by T. Этот метод извлечения данных также используется с фабриками каналов и прослушивателями каналов.This method of retrieval is also used on channel factories and channel listeners.

IChannel наследуется каждым интерфейсом канала, связанным с основными шаблонами обмена сообщениями:IChannel is inherited by each of the channel interfaces associated with the basic message-exchange patterns:

Свойства

State

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

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

Методы

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)
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)
EndClose(IAsyncResult)

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

(Унаследовано от ICommunicationObject)
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.

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)

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