IChannel Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Definierar det grundläggande gränssnitt som alla kanalobjekt måste implementera. Det kräver att de implementerar det tillståndsdatorgränssnitt som delas av alla kommunikationsobjekt och att de implementerar en metod för att hämta objekt från kanalstacken.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Härledda
- Implementeringar
Kommentarer
Important
Att anropa metoder från klasser som implementerar det här gränssnittet med ej betrodda data är en säkerhetsrisk. Anropa metoderna från klasser som endast implementerar det här gränssnittet med betrodda data. För mer information, se Verifiera alla indata.
Kanaler måste uppfylla kontraktet för en tillståndsdator enligt definitionen i ICommunicationObject gränssnittet.
Gränssnittet IChannel lägger till
GetProperty -metoden till ICommunicationObject gränssnittet. Den här metoden ger en mekanism för att hämta egenskaper från kanalstacken oavsett var i stacken dessa egenskaper finns. Termen "egenskap" i metodnamnet refererar till en information som tillhör någon av kanalerna i stacken. CLR-typen för den egenskapen bestäms av T. Den här metoden för hämtning används också på kanalfabriker och kanallyssnare.
IChannel ärvs av vart och ett av de kanalgränssnitt som är associerade med de grundläggande mönster för meddelandeutbyte:
IInputChannel för att ta emot meddelanden.
IOutputChannel för att skicka meddelanden.
IRequestChannel för att skicka en begäran.
IReplyChannel för att skicka ett svar.
IDuplexChannel för dubbelriktade meddelanden.
Egenskaper
| Name | Description |
|---|---|
| State |
Hämtar det aktuella tillståndet för det kommunikationsorienterade objektet. (Ärvd från ICommunicationObject) |
Metoder
| Name | Description |
|---|---|
| Abort() |
Gör att ett kommunikationsobjekt omedelbart övergår från dess aktuella tillstånd till det stängda tillståndet. (Ärvd från ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Påbörjar en asynkron åtgärd för att stänga ett kommunikationsobjekt. (Ärvd från ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Påbörjar en asynkron åtgärd för att stänga ett kommunikationsobjekt med en angiven tidsgräns. (Ärvd från ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt. (Ärvd från ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt inom ett angivet tidsintervall. (Ärvd från ICommunicationObject) |
| Close() |
Gör att ett kommunikationsobjekt övergår från dess aktuella tillstånd till det stängda tillståndet. (Ärvd från ICommunicationObject) |
| Close(TimeSpan) |
Gör att ett kommunikationsobjekt övergår från dess aktuella tillstånd till det stängda tillståndet. (Ärvd från ICommunicationObject) |
| EndClose(IAsyncResult) |
Slutför en asynkron åtgärd för att stänga ett kommunikationsobjekt. (Ärvd från ICommunicationObject) |
| EndOpen(IAsyncResult) |
Slutför en asynkron åtgärd för att öppna ett kommunikationsobjekt. (Ärvd från ICommunicationObject) |
| GetProperty<T>() |
Returnerar ett typat objekt som begärs, om det finns, från lämpligt lager i kanalstacken. |
| Open() |
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppnade tillståndet. (Ärvd från ICommunicationObject) |
| Open(TimeSpan) |
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppna tillståndet inom ett angivet tidsintervall. (Ärvd från ICommunicationObject) |
Händelser
| Name | Description |
|---|---|
| Closed |
Inträffar när kommunikationsobjektet slutför övergången från det avslutande tillståndet till det stängda tillståndet. (Ärvd från ICommunicationObject) |
| Closing |
Inträffar när kommunikationsobjektet först anger det avslutande tillståndet. (Ärvd från ICommunicationObject) |
| Faulted |
Inträffar när kommunikationsobjektet först anger det felaktiga tillståndet. (Ärvd från ICommunicationObject) |
| Opened |
Inträffar när kommunikationsobjektet slutför övergången från öppningstillståndet till det öppnade tillståndet. (Ärvd från ICommunicationObject) |
| Opening |
Inträffar när kommunikationsobjektet först anger öppningstillståndet. (Ärvd från ICommunicationObject) |