WebClient.UploadValuesAsync Método

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync(Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Parâmetros

Exceções

Observações

Este método envia uma cadeia para um recurso. A string é enviada de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads. Antes de carregar a cadeia, este método converte-a num Byte array usando a codificação especificada na Encoding propriedade. Para receber notificações quando o carregamento da string terminar, pode adicionar um gestor de eventos ao UploadStringCompleted evento.

Este método não bloqueia o thread que chama enquanto a string está a ser enviada. Para enviar uma cadeia e bloquear enquanto espera pela resposta do servidor, use um dos UploadString métodos.

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

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 UploadValues(Uri, NameValueCollection).

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Parâmetros

Exceções

Observações

Este método envia os dados contidos em a NameValueCollection para o address recurso. Use este método para enviar dados de formulário para um URI para processamento. Os dados são enviados usando o tipo de media form-urlencoded; o valor do cabeçalho Content-Type deve ser definido como "application/x-www-form-urlencoded". O cabeçalho está definido corretamente por defeito. Os UploadValuesAsync métodos lançam um WebException se chamares este método com um conjunto de valores de cabeçalho Content-Type diferente na Headers coleção.

Se o method método não for 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.

É NameValueCollection enviado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads. Para receber notificações quando a operação de upload terminar, adicione um gestor de eventos ao UploadValuesCompleted evento.

Este método não bloqueia o thread que chama enquanto a string está a ser enviada. Para enviar uma cadeia e bloquear enquanto espera pela resposta do servidor, use um dos UploadValues métodos.

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

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 estiver 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 UploadValues(Uri, String, NameValueCollection).

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);

public void UploadValuesAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data, object userToken);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Parâmetros

Exceções

Observações

Este método envia os dados contidos em a NameValueCollection para o address recurso. Use este método para enviar dados de formulário para um URI para processamento. Os dados são enviados usando o tipo de media form-urlencoded; o valor do cabeçalho Content-Type deve ser definido como "application/x-www-form-urlencoded". O cabeçalho está definido corretamente por defeito. Os UploadValuesAsync métodos lançam um WebException se chamares este método com um conjunto de valores de cabeçalho Content-Type diferente na Headers coleção.

Se o method método não for 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.

É NameValueCollection enviado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads. Para receber notificações quando a operação de upload terminar, adicione um gestor de eventos ao UploadValuesCompleted evento.

Este método não bloqueia o thread que chama enquanto a string está a ser enviada. Para enviar uma cadeia e bloquear enquanto espera pela resposta do servidor, use um dos UploadValues métodos.

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

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 estiver vazia, é anexada a address.