IChannel Interface
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Definieert de basisinterface die alle kanaalobjecten moeten implementeren. Hiervoor moeten ze de interface voor de statusmachine implementeren die wordt gedeeld door alle communicatieobjecten en dat ze een methode implementeren om objecten op te halen uit de kanaalstack.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Afgeleid
- Implementeringen
Opmerkingen
Important
Het aanroepen van methoden uit klassen die deze interface implementeren met niet-vertrouwde gegevens is een beveiligingsrisico. Roep de methoden aan vanuit klassen die deze interface alleen implementeren met vertrouwde gegevens. Zie Alle invoergegevens validerenvoor meer informatie.
Kanalen moeten voldoen aan het contract van een statusmachine zoals gedefinieerd door de ICommunicationObject interface.
De IChannel interface voegt de
GetProperty methode voor de ICommunicationObject interface. Deze methode biedt een mechanisme voor het ophalen van eigenschappen van de kanaalstack, ongeacht waar deze eigenschappen zich in de stack bevinden. De term 'eigenschap' in de methodenaam verwijst naar een stukje informatie dat deel uitmaakt van een van de kanalen in de stack. Het CLR-type voor die eigenschap wordt bepaald door T. Deze methode voor het ophalen wordt ook gebruikt voor kanaalfactory's en kanaallisteners.
IChannel wordt overgenomen door elk van de kanaalinterfaces die zijn gekoppeld aan de basispatronen voor berichtuitwisseling:
IInputChannel voor het ontvangen van berichten.
IOutputChannel voor het verzenden van berichten.
IRequestChannel voor het verzenden van een aanvraag.
IReplyChannel voor het verzenden van een antwoord.
IDuplexChannel voor bidirectionele berichten.
Eigenschappen
| Name | Description |
|---|---|
| State |
Hiermee haalt u de huidige status van het communicatiegeoriënteerde object op. (Overgenomen van ICommunicationObject) |
Methoden
| Name | Description |
|---|---|
| Abort() |
Zorgt ervoor dat een communicatieobject onmiddellijk van de huidige status overgaat naar de gesloten status. (Overgenomen van ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een communicatieobject te sluiten. (Overgenomen van ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een communicatieobject met een opgegeven time-out te sluiten. (Overgenomen van ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject te openen. (Overgenomen van ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject binnen een opgegeven tijdsinterval te openen. (Overgenomen van ICommunicationObject) |
| Close() |
Zorgt ervoor dat een communicatieobject van de huidige status overgaat naar de gesloten status. (Overgenomen van ICommunicationObject) |
| Close(TimeSpan) |
Zorgt ervoor dat een communicatieobject van de huidige status overgaat naar de gesloten status. (Overgenomen van ICommunicationObject) |
| EndClose(IAsyncResult) |
Hiermee voltooit u een asynchrone bewerking om een communicatieobject te sluiten. (Overgenomen van ICommunicationObject) |
| EndOpen(IAsyncResult) |
Voltooit een asynchrone bewerking om een communicatieobject te openen. (Overgenomen van ICommunicationObject) |
| GetProperty<T>() |
Retourneert een getypt object dat, indien aanwezig, is aangevraagd vanuit de juiste laag in de kanaalstack. |
| Open() |
Zorgt ervoor dat een communicatieobject wordt overgezet van de gemaakte status in de geopende status. (Overgenomen van ICommunicationObject) |
| Open(TimeSpan) |
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de gemaakte status overgaat naar de geopende status. (Overgenomen van ICommunicationObject) |
gebeurtenis
| Name | Description |
|---|---|
| Closed |
Treedt op wanneer het communicatieobject de overgang van de afsluitstatus naar de gesloten status voltooit. (Overgenomen van ICommunicationObject) |
| Closing |
Treedt op wanneer het communicatieobject voor het eerst de afsluitstatus invoert. (Overgenomen van ICommunicationObject) |
| Faulted |
Treedt op wanneer het communicatieobject de foutstatus voor het eerst invoert. (Overgenomen van ICommunicationObject) |
| Opened |
Treedt op wanneer het communicatieobject de overgang van de openingsstatus naar de geopende status voltooit. (Overgenomen van ICommunicationObject) |
| Opening |
Treedt op wanneer het communicatieobject voor het eerst de openingsstatus invoert. (Overgenomen van ICommunicationObject) |