IReplyChannel.BeginReceiveRequest Método

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Inicia uma operação assíncrona para receber uma solicitação disponível.

Sobrecargas

BeginReceiveRequest(AsyncCallback, Object)	Inicia uma operação assíncrona para receber uma solicitação disponível com um tempo limite padrão.
BeginReceiveRequest(TimeSpan, AsyncCallback, Object)	Inicia uma operação assíncrona para receber uma solicitação disponível com um tempo limite especificado.

BeginReceiveRequest(AsyncCallback, Object)

Inicia uma operação assíncrona para receber uma solicitação disponível com um tempo limite padrão.

public:
 IAsyncResult ^ BeginReceiveRequest(AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceiveRequest (AsyncCallback callback, object state);

abstract member BeginReceiveRequest : AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveRequest (callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

callback

AsyncCallback

O representante de AsyncCallback que recebe a notificação do recebimento assíncrono que uma operação de solicitação conclui.

state

Object

Um objeto, especificado pelo aplicativo, que contém informações de estado associadas ao recebimento assíncrono de uma operação de solicitação.

Retornos

IAsyncResult

O IAsyncResult que referencia o recebimento assíncrono da solicitação.

Exemplos

O código a seguir ilustra como implementar esse método:

public IAsyncResult BeginReceiveRequest(AsyncCallback callback, object state)
{
    return BeginReceiveRequest(DefaultReceiveTimeout, callback, state);
}

Comentários

O BeginReceiveRequest(AsyncCallback, Object) método implementa o padrão padrão para invocar ReceiveRequest() de forma assíncrona. O tempo limite padrão é de 1 minuto. Se um tempo limite de recebimento for definido na associação usada para configurar a conexão, esse valor será usado. Use BeginReceiveRequest(TimeSpan, AsyncCallback, Object) se você quiser especificar um tempo limite explícito com a chamada que substitui esses outros valores.

Se a mensagem de solicitação recebida for maior que o tamanho máximo da mensagem permitida pela associação que está sendo usada, uma QuotaExceededException será gerada. O tamanho máximo da mensagem é definido pela MaxReceivedMessageSize propriedade . O valor padrão é 65536 bytes.

BeginReceiveRequest(TimeSpan, AsyncCallback, Object)

Inicia uma operação assíncrona para receber uma solicitação disponível com um tempo limite especificado.

public:
 IAsyncResult ^ BeginReceiveRequest(TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceiveRequest (TimeSpan timeout, AsyncCallback callback, object state);

abstract member BeginReceiveRequest : TimeSpan * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveRequest (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

timeout

TimeSpan

O TimeSpan que especifica o intervalo de tempo de espera para o recebimento de uma solicitação disponível.

callback

AsyncCallback

O representante de AsyncCallback que recebe a notificação do recebimento assíncrono que uma operação de solicitação conclui.

state

Object

Um objeto, especificado pelo aplicativo, que contém informações de estado associadas ao recebimento assíncrono de uma operação de solicitação.

Retornos

IAsyncResult

O IAsyncResult que referencia o recebimento assíncrono da solicitação.

Exemplos

O código a seguir ilustra como implementar esse método:

public IAsyncResult BeginReceiveRequest(TimeSpan timeout, AsyncCallback callback, object state)
{
    ReceiveRequestAsyncResult result = new ReceiveRequestAsyncResult(this, timeout, callback, state);
    result.Begin();
    return result;
}

Comentários

O BeginReceiveRequest(TimeSpan, AsyncCallback, Object) método implementa o padrão padrão para invocar ReceiveRequest(TimeSpan) de forma assíncrona. O tempo limite definido nesse método substitui um tempo limite de recebimento definido na associação usada para configurar a conexão.

Se a mensagem de solicitação recebida for maior que o tamanho máximo da mensagem permitida pela associação que está sendo usada, uma QuotaExceededException será gerada. O tamanho máximo da mensagem é definido pela MaxReceivedMessageSize propriedade . O valor padrão é 65536 bytes.