IChannel Interfejs

Definicja

Definiuje podstawowy interfejs, który musi implementować wszystkie obiekty kanału.Defines the basic interface that all channel objects must implement. Wymaga, aby implementują interfejs komputera stanu współużytkowany przez wszystkie obiekty komunikacyjne i implementujący metodę pobierania obiektów ze stosu kanału.It requires that they implement the state machine interface shared by all communication objects and that they implement a method to retrieve objects from the channel stack.

public interface class IChannel : System::ServiceModel::ICommunicationObject
public interface IChannel : System.ServiceModel.ICommunicationObject
type IChannel = interface
    interface ICommunicationObject
Public Interface IChannel
Implements ICommunicationObject
Pochodne
Implementuje

Uwagi

Ważne

Wywoływanie metod z klas implementujących ten interfejs z niezaufanymi danymi stanowi zagrożenie bezpieczeństwa.Calling methods from classes that implement this interface with untrusted data is a security risk. Wywołaj metody z klas, które implementują ten interfejs tylko przy użyciu zaufanych danych.Call the methods from classes that implement this interface only with trusted data. Aby uzyskać więcej informacji, zobacz Sprawdzanie poprawności danych.For more information, see Data Validation.

Kanały muszą spełniać umowę automatu Stanów, zgodnie z definicją w ICommunicationObject interfejsie.Channels must satisfy the contract of a state machine as defined by the ICommunicationObject interface.

IChannelInterfejs dodajeThe IChannel interface adds the

GetProperty Metoda do ICommunicationObject interfejsu.GetProperty method to the ICommunicationObject interface. Ta metoda zapewnia mechanizm pobierania właściwości z stosu kanału niezależnie od tego, gdzie w stosie te właściwości są aktywne.This method provides a mechanism for retrieving properties from the channel stack regardless of where in the stack those properties live. Termin "Property" w nazwie metody odnosi się do informacji, które należą do jednego z kanałów w stosie.The term "property" in the method name refers to a piece of information that belongs to one of the channels in the stack. Typ CLR dla tej właściwości jest określany przez T .The CLR type for that property is determined by T. Ta metoda pobierania jest również używana w przypadku fabryk kanałów i odbiorników kanałów.This method of retrieval is also used on channel factories and channel listeners.

IChannel jest dziedziczona przez każdy z interfejsów kanałów skojarzonych z podstawowymi wzorcami komunikatów — Exchange:IChannel is inherited by each of the channel interfaces associated with the basic message-exchange patterns:

Właściwości

State

Pobiera bieżący stan obiektu zorientowanego na komunikację.Gets the current state of the communication-oriented object.

(Odziedziczone po ICommunicationObject)

Metody

Abort()

Powoduje, że obiekt komunikacyjny przechodzi natychmiast od bieżącego stanu do stanu zamkniętego.Causes a communication object to transition immediately from its current state into the closed state.

(Odziedziczone po ICommunicationObject)
BeginClose(AsyncCallback, Object)

Rozpoczyna operację asynchroniczną zamykającą obiekt komunikacyjny.Begins an asynchronous operation to close a communication object.

(Odziedziczone po ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Rozpoczyna operację asynchroniczną zamykającą obiekt komunikacyjny z określonym limitem czasu.Begins an asynchronous operation to close a communication object with a specified timeout.

(Odziedziczone po ICommunicationObject)
BeginOpen(AsyncCallback, Object)

Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacyjny.Begins an asynchronous operation to open a communication object.

(Odziedziczone po ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacyjny w określonym przedziale czasu.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Odziedziczone po ICommunicationObject)
Close()

Powoduje, że obiekt komunikacyjny przechodzi od bieżącego stanu do stanu zamkniętego.Causes a communication object to transition from its current state into the closed state.

(Odziedziczone po ICommunicationObject)
Close(TimeSpan)

Powoduje, że obiekt komunikacyjny przechodzi od bieżącego stanu do stanu zamkniętego.Causes a communication object to transition from its current state into the closed state.

(Odziedziczone po ICommunicationObject)
EndClose(IAsyncResult)

Kończy operację asynchroniczną w celu zamknięcia obiektu komunikacyjnego.Completes an asynchronous operation to close a communication object.

(Odziedziczone po ICommunicationObject)
EndOpen(IAsyncResult)

Kończy operację asynchroniczną, aby otworzyć obiekt komunikacyjny.Completes an asynchronous operation to open a communication object.

(Odziedziczone po ICommunicationObject)
GetProperty<T>()

Zwraca żądany obiekt typu, jeśli jest obecny, z odpowiedniej warstwy w stosie kanału.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

Open()

Powoduje, że obiekt komunikacyjny przechodzi ze stanu utworzonego do stanu otwarty.Causes a communication object to transition from the created state into the opened state.

(Odziedziczone po ICommunicationObject)
Open(TimeSpan)

Powoduje, że obiekt komunikacyjny przechodzi ze stanu utworzonego do stanu otwarty w określonym przedziale czasu.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Odziedziczone po ICommunicationObject)

Zdarzenia

Closed

Występuje, gdy obiekt komunikacyjny kończy przejście ze stanu zamykania do stanu zamkniętego.Occurs when the communication object completes its transition from the closing state into the closed state.

(Odziedziczone po ICommunicationObject)
Closing

Występuje, gdy obiekt komunikacyjny zostanie po raz pierwszy przesunięty w stan zamknięcia.Occurs when the communication object first enters the closing state.

(Odziedziczone po ICommunicationObject)
Faulted

Występuje, gdy obiekt komunikacyjny zostanie po raz pierwszy przesunięty w stan błędu.Occurs when the communication object first enters the faulted state.

(Odziedziczone po ICommunicationObject)
Opened

Występuje, gdy obiekt komunikacyjny zakończy przejście ze stanu otwarcia do stanu otwarty.Occurs when the communication object completes its transition from the opening state into the opened state.

(Odziedziczone po ICommunicationObject)
Opening

Występuje, gdy obiekt komunikacyjny zostanie po raz pierwszy przesunięty w stan otwarcia.Occurs when the communication object first enters the opening state.

(Odziedziczone po ICommunicationObject)

Dotyczy