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

Observações

Este método recupera um fluxo gravável que é usado para enviar dados a um recurso. O fluxo é recuperado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o stream estiver disponível, adicione um gestor de eventos ao OpenWriteCompleted evento. O conteúdo da transmissão é enviado para o servidor quando fecha a transmissão.

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, a WebException é lançado com a Status propriedade definida para indicar o erro.

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

Este método não bloqueia o fio que chama enquanto o fluxo está a ser aberto. Para bloquear enquanto espera pelo fluxo, use um dos OpenWrite métodos.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada 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

Observações

Este método recupera um fluxo gravável que é usado para enviar dados a um recurso. O fluxo é recuperado usando recursos de thread que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o stream estiver disponível, adicione um gestor de eventos ao OpenWriteCompleted evento. Quando fechas o fluxo, o thread bloqueia até que o pedido seja enviado address e receba uma resposta.

Este método não bloqueia o fio que chama enquanto o fluxo está a ser aberto. Para bloquear enquanto espera pelo fluxo, use um dos OpenWrite métodos.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Este método recupera um fluxo gravável que é usado para enviar dados a um recurso. O fluxo é recuperado usando recursos de thread que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o stream estiver disponível, adicione um gestor de eventos ao OpenWriteCompleted evento. Quando fechas o fluxo, o thread bloqueia até que o pedido seja enviado address e receba uma resposta.

Este método não bloqueia o fio que chama enquanto o fluxo está a ser aberto. Para bloquear enquanto espera pelo fluxo, use um dos OpenWrite métodos.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.

Este método utiliza o comando STOR para carregar um recurso FTP. Para um recurso HTTP, é utilizado o método POST.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por OpenWrite(Uri).