IInputChannel 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 interface die een kanaal moet implementeren om een bericht te ontvangen.
public interface class IInputChannel : System::ServiceModel::Channels::IChannelpublic interface IInputChannel : System.ServiceModel.Channels.IChanneltype IInputChannel = interface
interface IChannel
interface ICommunicationObjectPublic Interface IInputChannel
Implements IChannel- 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.
Het IInputChannel contract bevat synchrone en asynchrone varianten van ontvangst, try-to-receive en wait-for-a-message-functionaliteit.
Het pull-model wordt meestal gebruikt voor het IInputChannel ontvangen van berichten: u belt Receive (om een bericht uit het kanaal te halen) en wacht vervolgens tot een bericht binnenkomt. Een alternatief gebruikspatroon is het aanroepen of aanroepen BeginWaitForMessage(TimeSpan, AsyncCallback, Object) en vervolgens aanroepenReceive(TimeSpan).BeginWaitForMessage(TimeSpan, AsyncCallback, Object) Deze benadering is gebruikelijk voor transactioneel gebruik waarbij u de transactie tussen de aanroepen naar WaitForMessage(TimeSpan) en Receive.
Een IInputChannel is niet noodzakelijkerwijs gebonden aan één afzender. Andere kanalen en kanaalinterfaces kunnen een correlatie bieden tussen bepaalde afzenders en een IInputChannel, maar het basiscontract maakt geen dergelijke beperking. Een implementatie kan voor elk bericht een nieuw IInputChannel bericht maken of hetzelfde IInputChannel hergebruiken voor meerdere berichten en afzenders.
Eigenschappen
| Name | Description |
|---|---|
| LocalAddress |
Hiermee haalt u het adres op waarop het invoerkanaal berichten ontvangt. |
| 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) |
| BeginReceive(AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een bericht te ontvangen waaraan een statusobject is gekoppeld. |
| BeginReceive(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een bericht te ontvangen met een opgegeven time-out en statusobject dat eraan is gekoppeld. |
| BeginTryReceive(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een bericht te ontvangen met een opgegeven time-out en statusobject dat eraan is gekoppeld. |
| BeginWaitForMessage(TimeSpan, AsyncCallback, Object) |
Hiermee begint u een asynchrone wacht-op-een-bericht-naar-arrive-bewerking met een opgegeven time-out en statusobject dat eraan is gekoppeld. |
| 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) |
| EndReceive(IAsyncResult) |
Hiermee wordt een asynchrone bewerking voltooid om een bericht te ontvangen. |
| EndTryReceive(IAsyncResult, Message) |
Voltooit de opgegeven asynchrone bewerking om een bericht te ontvangen. |
| EndWaitForMessage(IAsyncResult) |
Hiermee voltooit u de opgegeven asynchrone wait-for-a-message-bewerking. |
| GetProperty<T>() |
Retourneert een getypt object dat, indien aanwezig, is aangevraagd vanuit de juiste laag in de kanaalstack. (Overgenomen van IChannel) |
| 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) |
| Receive() |
Retourneert het ontvangen bericht, indien beschikbaar. Als een bericht niet beschikbaar is, worden blokken voor een standaardinterval van tijd geblokkeerd. |
| Receive(TimeSpan) |
Retourneert het ontvangen bericht, indien beschikbaar. Als een bericht niet beschikbaar is, worden blokken voor een opgegeven tijdsinterval geblokkeerd. |
| TryReceive(TimeSpan, Message) |
Probeert een bericht te ontvangen binnen een opgegeven tijdsinterval. |
| WaitForMessage(TimeSpan) |
Retourneert een waarde die aangeeft of een bericht binnen een opgegeven tijdsinterval is aangekomen. |
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) |
