IInputChannel.Receive Método

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v8.1.0

Retornará uma mensagem recebida pelo canal de entrada, se houver um disponível com um intervalo de tempo definido implícita ou explicitamente.

Sobrecargas

Receive()	Retornará a mensagem recebida, se houver uma disponível. Se uma mensagem não estiver disponível, será bloqueado por um intervalo de tempo padrão.
Receive(TimeSpan)	Retornará a mensagem recebida, se houver uma disponível. Se uma mensagem não estiver disponível, será bloqueado por um intervalo de tempo especificado.

Comentários

Use o método síncrono Receive quando for aceitável que o thread atual seja bloqueado até que ele receba a mensagem de solicitação ou exceda o intervalo de tempo especificado por timeout. Use o método assíncrono BeginReceive quando precisar que o processamento do aplicativo continue sem aguardar o recebimento da solicitação.

A operação síncrona Receive está disponível com ou sem um tempo limite explícito.

Se uma mensagem não estiver disponível, ela será bloqueada até que uma esteja disponível ou até que o tempo limite seja excedido.

Receive()

Origem:

IInputChannel.cs

Retornará a mensagem recebida, se houver uma disponível. Se uma mensagem não estiver disponível, será bloqueado por um intervalo de tempo padrão.

public:
 System::ServiceModel::Channels::Message ^ Receive();

public System.ServiceModel.Channels.Message Receive ();

abstract member Receive : unit -> System.ServiceModel.Channels.Message

Public Function Receive () As Message

Retornos

Message

O Message recebido.

Exemplos

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

public Message Receive()
{
    return Receive(DefaultReceiveTimeout);
}

Comentários

Use o método síncrono Receive quando for aceitável que o thread atual seja bloqueado até que ele receba a mensagem de solicitação ou exceda o intervalo de tempo especificado por timeout. Use o método assíncrono BeginReceive quando desejar que o processamento do aplicativo continue sem aguardar o recebimento da solicitação.

A operação síncrona Receive está disponível com ou sem um tempo limite explícito.

Se uma mensagem não estiver disponível, ela será bloqueada até que uma esteja disponível ou até que o tempo limite seja excedido.

Receive pode ser chamado várias vezes ou simultaneamente. Somente uma Receive chamada pode ser concluída para cada mensagem recebida.

Receive(TimeSpan)

Origem:

IInputChannel.cs

Retornará a mensagem recebida, se houver uma disponível. Se uma mensagem não estiver disponível, será bloqueado por um intervalo de tempo especificado.

public:
 System::ServiceModel::Channels::Message ^ Receive(TimeSpan timeout);

public System.ServiceModel.Channels.Message Receive (TimeSpan timeout);

abstract member Receive : TimeSpan -> System.ServiceModel.Channels.Message

Public Function Receive (timeout As TimeSpan) As Message

Parâmetros

timeout

TimeSpan

O TimeSpan que especifica quanto tempo a operação de recebimento tem para ser concluída antes de atingir o tempo limite e retornar TimeoutException.

Retornos

Message

O Message recebido.

Exceções

TimeoutException

O timeout especificado é ultrapassado antes que a operação seja concluída.

ArgumentOutOfRangeException

O tempo limite especificado é menor que zero.

Exemplos

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

public Message Receive(TimeSpan timeout)
{
    Message message;
    while (true)
    {
        message = this.InnerChannel.Receive(timeout);
        if (ProcessReceivedMessage(ref message))
        {
            break;
        }
    }

    return message;
}

Comentários

Use o método síncrono Receive quando for aceitável que o thread atual seja bloqueado até que ele receba a mensagem de solicitação ou exceda o intervalo de tempo especificado por timeout. Use o método assíncrono BeginReceive quando desejar que o processamento do aplicativo continue sem aguardar o recebimento da solicitação.

A operação síncrona Receive está disponível com ou sem um tempo limite explícito.

Se uma mensagem não estiver disponível, ela será bloqueada até que uma esteja disponível ou até que o tempo limite seja excedido.

Receive pode ser chamado várias vezes ou simultaneamente. Somente uma Receive chamada pode ser concluída para cada mensagem recebida.