Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Método PipeStream.BeginRead

.NET Framework 4.5

Outras versões

Começa uma operação de leitura assíncrona.

Namespace: System.IO.Pipes
Assembly: System.Core (em System.Core.dll)

Sintaxe

C++

[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public override IAsyncResult BeginRead(
	byte[] buffer,
	int offset,
	int count,
	AsyncCallback callback,
	Object state
)

Parâmetros

buffer: Tipo: System.Byte[]
O buffer para ler os dados.

offset: Tipo: System.Int32
O deslocamento de byte no buffer em que começa a leitura.

count: Tipo: System.Int32
O número máximo de bytes a serem lidos.

callback: Tipo: System.AsyncCallback
Método a ser chamado quando a operação de leitura assíncrona for concluído.

state: Tipo: System.Object
Um objeto fornecido pelo usuário que diferencia essa determinada solicitação de leitura assíncrona de outras solicitações.

Valor de retorno

Tipo: System.IAsyncResult
Um IAsyncResult leia do objeto que faz referência a assíncrona.

Exceções

Exceção	Condição
ArgumentNullException	buffer é null.
ArgumentOutOfRangeException	offseté menor que 0. -ou- counté menor que 0.
ArgumentException	counté maior que o número de bytes disponíveis em buffer.
ObjectDisposedException	O pipe é fechado.
NotSupportedException	O pipe não oferece suporte a operações de leitura.
InvalidOperationException	O pipe é desconectado, aguardando conexão ou a alça não foi definido.
IOException	O pipe está quebrado ou ocorreu outro erro de e/S.

Comentários

Passar o retornado IAsyncResult o objeto para o EndRead método para determinar quantos bytes foram lidos e liberar recursos do sistema operacional usados para leitura. EndRead deve ser chamado uma vez para cada chamada para BeginRead. Isso pode ser feito tanto o mesmo código que chamou BeginRead ou um retorno de chamada que é passado para BeginRead.

Use o CanRead propriedade para determinar se o atual PipeStream objeto suporta operações de leitura.

Se o pipe é fechado ou um argumento inválido é passado para BeginRead, as exceções adequadas são disparadas imediatamente. Erros que ocorrem durante uma solicitação de leitura assíncrona ocorrerem no thread do pool que está realizando a solicitação. As exceções são disparadas quando o código chama o EndRead método.

Observação
O atributo HostProtectionAttribute aplicado a este tipo ou membro tem o seguinte valor da propriedade Resources: ExternalThreading. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a classe HostProtectionAttribute ou Atributos de proteção de Host e programação de SQL Server.

Observação

O atributo HostProtectionAttribute aplicado a este tipo ou membro tem o seguinte valor da propriedade Resources: ExternalThreading. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a classe HostProtectionAttribute ou Atributos de proteção de Host e programação de SQL Server.

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Consulte também

Referência

PipeStream Classe

Namespace System.IO.Pipes

Isso foi útil para você? Sim Não

Impreciso

Sem profundidade suficiente

Mais exemplos de código são necessários

A tradução precisa ser aprimorada

(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR