WebClient.OpenWriteAsync Método

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);

public void OpenWriteAsync(Uri address, string method, object userToken);

member this.OpenWriteAsync : Uri * string * obj -> unit

Public Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)

Parâmetros

Exceções

Comentários

Esse método recupera um fluxo gravável que é usado para enviar dados para um recurso. O fluxo é recuperado de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads. Para receber uma notificação quando o fluxo estiver disponível, adicione um manipulador de eventos ao OpenWriteCompleted evento. O conteúdo do fluxo é enviado ao servidor quando você fecha o fluxo.

Se o method parâmetro especificar um método que não é compreendido pelo servidor, as classes de protocolo subjacentes determinam o que ocorre. Normalmente, um WebException é gerado com a Status propriedade definida para indicar o erro.

No .NET Framework, você pode cancelar operações assíncronas que não foram concluídas chamando o CancelAsync método.

Esse método não bloqueia o thread de chamada enquanto o fluxo está sendo aberto. Para bloquear enquanto aguarda o fluxo, use um dos OpenWrite métodos.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);

public void OpenWriteAsync(Uri address, string method);

member this.OpenWriteAsync : Uri * string -> unit

Public Sub OpenWriteAsync (address As Uri, method As String)

Parâmetros

Exceções

Comentários

Esse método recupera um fluxo gravável que é usado para enviar dados para um recurso. O fluxo é recuperado usando recursos de thread que são alocados automaticamente do pool de threads. Para receber uma notificação quando o fluxo estiver disponível, adicione um manipulador de eventos ao OpenWriteCompleted evento. Quando você fecha o fluxo, o thread bloqueia até que a solicitação seja enviada address e uma resposta seja recebida.

Esse método não bloqueia o thread de chamada enquanto o fluxo está sendo aberto. Para bloquear enquanto aguarda o fluxo, use um dos OpenWrite métodos.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por OpenWrite(Uri, String).

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync(Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

Parâmetros

Exceções

Comentários

Esse método recupera um fluxo gravável que é usado para enviar dados para um recurso. O fluxo é recuperado usando recursos de thread que são alocados automaticamente do pool de threads. Para receber uma notificação quando o fluxo estiver disponível, adicione um manipulador de eventos ao OpenWriteCompleted evento. Quando você fecha o fluxo, o thread bloqueia até que a solicitação seja enviada address e uma resposta seja recebida.

Esse método não bloqueia o thread de chamada enquanto o fluxo está sendo aberto. Para bloquear enquanto aguarda o fluxo, use um dos OpenWrite métodos.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por OpenWrite(Uri).