IChannel Interfejs

Definicja

Przestrzeń nazw:

System.ServiceModel.Channels

Zestaw:

System.ServiceModel.Primitives.dll

Zestaw:

System.ServiceModel.dll

Definiuje podstawowy interfejs, który musi implementować wszystkie obiekty kanału. Wymaga to zaimplementowania interfejsu maszyny stanu współużytkowanej przez wszystkie obiekty komunikacyjne i że implementują metodę pobierania obiektów ze stosu kanału.

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

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Pochodne

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

Implementuje

ICommunicationObject

Uwagi

Ważne

Wywoływanie metod z klas implementujących ten interfejs z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj metody z klas, które implementują ten interfejs tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Weryfikowanie wszystkich danych wejściowych.

Kanały muszą spełniać kontrakt maszyny stanu zdefiniowanej ICommunicationObject przez interfejs.

Interfejs IChannel dodaje element

GetProperty metoda interfejsu ICommunicationObject . Ta metoda zapewnia mechanizm pobierania właściwości ze stosu kanału niezależnie od tego, gdzie znajdują się te właściwości. Termin "property" w nazwie metody odnosi się do fragmentu informacji należących do jednego z kanałów w stosie. Typ clR dla tej właściwości jest określany przez T. Ta metoda pobierania jest również używana w fabrykach kanałów i odbiornikach kanałów.

IChannel jest dziedziczony przez każdy z interfejsów kanału skojarzonych z podstawowymi wzorcami wymiany komunikatów:

• IInputChannel do odbierania komunikatów.

• IOutputChannel do wysyłania komunikatów.

• IRequestChannel do wysyłania żądania.

• IReplyChannel do wysyłania odpowiedzi.

• IDuplexChannel do obsługi komunikatów dwukierunkowych.

Właściwości

State

Pobiera bieżący stan obiektu zorientowanego na komunikację. (Odziedziczone po ICommunicationObject)

Metody

Abort()	Powoduje natychmiastowe przejście obiektu komunikacyjnego z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ICommunicationObject)
BeginClose(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby zamknąć obiekt komunikacji. (Odziedziczone po ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby zamknąć obiekt komunikacji z określonym limitem czasu. (Odziedziczone po ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji. (Odziedziczone po ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji w określonym przedziale czasu. (Odziedziczone po ICommunicationObject)
Close()	Powoduje przejście obiektu komunikacji z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ICommunicationObject)
Close(TimeSpan)	Powoduje przejście obiektu komunikacji z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ICommunicationObject)
EndClose(IAsyncResult)	Kończy operację asynchroniczną, aby zamknąć obiekt komunikacji. (Odziedziczone po ICommunicationObject)
EndOpen(IAsyncResult)	Kończy operację asynchroniczną, aby otworzyć obiekt komunikacyjny. (Odziedziczone po ICommunicationObject)
GetProperty<T>()	Zwraca żądany obiekt typu z odpowiedniej warstwy w stosie kanału.
Open()	Powoduje przejście obiektu komunikacji z utworzonego stanu do stanu otwartego. (Odziedziczone po ICommunicationObject)
Open(TimeSpan)	Powoduje przejście obiektu komunikacji z utworzonego stanu do stanu otwartego w określonym przedziale czasu. (Odziedziczone po ICommunicationObject)

Zdarzenia

Closed	Występuje, gdy obiekt komunikacji zakończy przejście ze stanu zamknięcia do stanu zamkniętego. (Odziedziczone po ICommunicationObject)
Closing	Występuje, gdy obiekt komunikacji najpierw wchodzi w stan zamknięcia. (Odziedziczone po ICommunicationObject)
Faulted	Występuje, gdy obiekt komunikacji po raz pierwszy wchodzi w stan błędu. (Odziedziczone po ICommunicationObject)
Opened	Występuje, gdy obiekt komunikacji zakończy przejście ze stanu otwierania do otwartego stanu. (Odziedziczone po ICommunicationObject)
Opening	Występuje, gdy obiekt komunikacji najpierw wchodzi w stan otwarcia. (Odziedziczone po ICommunicationObject)