IChannel Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 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é
- Implementuje
Poznámky
Důležité
Volání metod z tříd, které implementují toto rozhraní s nedůvěryhodnými daty, je 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í splňovat kontrakt stavového počítače definovaného rozhraním ICommunicationObject .
Rozhraní IChannel přidá
GetProperty metodu ICommunicationObject pro 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 aktivní. Termín "vlastnost" v názvu metody odkazuje na část informací, které patří do jednoho z kanálů v zásobníku. Typ CLR pro tuto vlastnost je určen .T
Tato metoda načítání se používá také v kanálových továrnách a naslouchacích procesech kanálů.
IChannel
je zděděna jednotlivými rozhraními kanálu přidruženými 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 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í, že komunikační objekt přejde okamžitě ze svého aktuálního stavu do uzavřeného stavu. (Zděděno od ICommunicationObject) |
BeginClose(AsyncCallback, Object) |
Zahájí asynchronní operaci uzavř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 otevření komunikačního objektu. (Zděděno od ICommunicationObject) |
BeginOpen(TimeSpan, AsyncCallback, Object) |
Zahájí asynchronní operaci otevření komunikačního objektu 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 pro zavření komunikačního objektu. (Zděděno od ICommunicationObject) |
EndOpen(IAsyncResult) |
Dokončí asynchronní operaci pro otevření komunikačního objektu. (Zděděno od ICommunicationObject) |
GetProperty<T>() |
Vrátí požadovaný typ objektu z příslušné vrstvy v zásobníku kanálu. |
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čí svůj přechod z koncového stavu do uzavřeného stavu. (Zděděno od ICommunicationObject) |
Closing |
Nastane při prvním vstupu komunikačního objektu do konečného stavu. (Zděděno od ICommunicationObject) |
Faulted |
Nastane, když komunikační objekt poprvé vstoupí do chybného stavu. (Zděděno od ICommunicationObject) |
Opened |
Nastane, když komunikační objekt dokončí svůj přechod z počátečního stavu do otevřeného stavu. (Zděděno od ICommunicationObject) |
Opening |
Nastane, když komunikační objekt poprvé vstoupí do počátečního stavu. (Zděděno od ICommunicationObject) |