IChannel Rozhraní

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

Zdroj:

IChannel.cs

Definuje základní rozhraní, které musí implementovat všechny objekty kanálu. Vyžaduje, aby implementovali rozhraní stavového počítače sdílené všemi komunikačními objekty a aby implementovali metodu pro načtení objektů ze zásobníku kanálů.

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

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Odvozené

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IAsyncInputChannel

System.ServiceModel.Channels.IAsyncOutputChannel

System.ServiceModel.Channels.IAsyncOutputSessionChannel

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.Channels.OutputChannel

System.ServiceModel.Channels.RequestChannel

System.ServiceModel.Channels.ServiceChannelProxy

System.ServiceModel.Channels.TransportDuplexSessionChannel

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

System.ServiceModel.Federation.WSTrustChannel

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Implementuje

ICommunicationObject

Poznámky

Důležité

Volání metod z tříd, které implementují toto rozhraní s nedůvěryhodnými daty, představuje bezpečnostní riziko. Volejte metody z tříd, které implementují toto rozhraní pouze s důvěryhodnými daty. Další informace najdete v tématu Ověření všech vstupů.

Kanály musí vyhovovat kontraktu stavového počítače definovaného rozhraním ICommunicationObject .

Rozhraní IChannel přidá

GetPropertyICommunicationObject do rozhraní. Tato metoda poskytuje mechanismus pro načtení vlastností ze zásobníku kanálu bez ohledu na to, kde jsou tyto vlastnosti v zásobníku. Termín "vlastnost" v názvu metody odkazuje na informace, které patří do jednoho z kanálů v zásobníku. Typ CLR pro danou vlastnost je určen parametrem T. Tato metoda načítání se používá také u továren kanálů a naslouchacích procesů kanálu.

IChannel zdědí všechna rozhraní kanálů přidružená k základním vzorům výměny zpráv:

• IInputChannel pro příjem zpráv.

• IOutputChannel pro odesílání zpráv.

• IRequestChannel pro odeslání žádosti.

• IReplyChannel pro odeslání odpovědi.

• IDuplexChannel pro obousměrné zasílání zpráv.

Vlastnosti

State

Získá aktuální stav objektu orientovaného na komunikaci. (Zděděno od ICommunicationObject)

Metody

Abort()	Způsobí okamžitý přechod komunikačního objektu z aktuálního stavu do uzavřeného stavu. (Zděděno od ICommunicationObject)
BeginClose(AsyncCallback, Object)	Zahájí asynchronní operaci k zavření komunikačního objektu. (Zděděno od ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Zahájí asynchronní operaci uzavření komunikačního objektu se zadaným časovým limitem. (Zděděno od ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Zahájí asynchronní operaci k otevření komunikačního objektu. (Zděděno od ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Zahájí asynchronní operaci, která otevře komunikační objekt v zadaném časovém intervalu. (Zděděno od ICommunicationObject)
Close()	Způsobí přechod komunikačního objektu z aktuálního stavu do uzavřeného stavu. (Zděděno od ICommunicationObject)
Close(TimeSpan)	Způsobí přechod komunikačního objektu z aktuálního stavu do uzavřeného stavu. (Zděděno od ICommunicationObject)
EndClose(IAsyncResult)	Dokončí asynchronní operaci k zavření komunikačního objektu. (Zděděno od ICommunicationObject)
EndOpen(IAsyncResult)	Dokončí asynchronní operaci k otevření komunikačního objektu. (Zděděno od ICommunicationObject)
GetProperty<T>()	Vrátí typovaný objekt požadovaný, pokud je k dispozici, z příslušné vrstvy v zásobníku kanálů.
Open()	Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu. (Zděděno od ICommunicationObject)
Open(TimeSpan)	Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu v zadaném časovém intervalu. (Zděděno od ICommunicationObject)

Událost

Closed	Nastane, když komunikační objekt dokončí přechod z uzavírací do uzavřeného stavu. (Zděděno od ICommunicationObject)
Closing	Nastane, když komunikační objekt poprvé přejde do uzavíracího stavu. (Zděděno od ICommunicationObject)
Faulted	Nastane, když komunikační objekt poprvé přejde do chybného stavu. (Zděděno od ICommunicationObject)
Opened	Nastane, když komunikační objekt dokončí svůj přechod ze stavu otevření do otevřeného stavu. (Zděděno od ICommunicationObject)
Opening	Nastane, když komunikační objekt poprvé přejde do stavu otevření. (Zděděno od ICommunicationObject)

Metody rozšíření

CloseHelperAsync(ICommunicationObject, TimeSpan)	Definuje základní rozhraní, které musí implementovat všechny objekty kanálu. Vyžaduje, aby implementovali rozhraní stavového počítače sdílené všemi komunikačními objekty a aby implementovali metodu pro načtení objektů ze zásobníku kanálů.
OpenHelperAsync(ICommunicationObject, TimeSpan)	Definuje základní rozhraní, které musí implementovat všechny objekty kanálu. Vyžaduje, aby implementovali rozhraní stavového počítače sdílené všemi komunikačními objekty a aby implementovali metodu pro načtení objektů ze zásobníku kanálů.