WebClient.UploadDataAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Carrega um buffer de dados para um recurso identificado por um URI. Este método não bloqueia o thread que chama.
Sobrecargas
| Name | Description |
|---|---|
| UploadDataAsync(Uri, String, Byte[]) |
Carrega um buffer de dados para um recurso identificado por um URI, usando o método especificado. Este método não bloqueia o thread que chama. |
| UploadDataAsync(Uri, String, Byte[], Object) |
Carrega um buffer de dados para um recurso identificado por um URI, usando o método especificado e o token identificador. |
| UploadDataAsync(Uri, Byte[]) |
Carrega um buffer de dados para um recurso identificado por um URI, usando o método POST. Este método não bloqueia o thread que chama. |
UploadDataAsync(Uri, String, Byte[])
Carrega um buffer de dados para um recurso identificado por um URI, usando o método especificado. Este método não bloqueia o thread que chama.
public:
void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);public void UploadDataAsync(Uri address, string method, byte[] data);member this.UploadDataAsync : Uri * string * byte[] -> unitPublic Sub UploadDataAsync (address As Uri, method As String, data As Byte())Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
- method
- String
O método utilizado para enviar os dados para o recurso. Se null, o padrão é POST para http e STOR para ftp.
- data
- Byte[]
O buffer de dados para enviar ao recurso.
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
-ou-
Não houve resposta do servidor que hospedava o recurso.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Este método envia um buffer de dados para um recurso. O buffer de dados é enviado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads. Os dados não são codificados. Para receber notificações quando o carregamento dos dados terminar, adicione um gestor de eventos ao UploadDataCompleted evento.
Este método não bloqueia a thread que chama enquanto os dados estão a ser enviados. Para enviar dados e bloquear enquanto espera a resposta do servidor, use um dos UploadData 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.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
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 UploadData(Uri, String, Byte[]).
Aplica-se a
UploadDataAsync(Uri, String, Byte[], Object)
Carrega um buffer de dados para um recurso identificado por um URI, usando o método especificado e o token identificador.
public:
void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);public void UploadDataAsync(Uri address, string method, byte[] data, object userToken);member this.UploadDataAsync : Uri * string * byte[] * obj -> unitPublic Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
- method
- String
O método utilizado para enviar os dados para o recurso. Se null, o padrão é POST para http e STOR para ftp.
- data
- Byte[]
O buffer de dados para enviar ao recurso.
- userToken
- Object
Um objeto definido pelo utilizador que é passado para o método invocado quando a operação assíncrona termina.
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
-ou-
Não houve resposta do servidor que hospedava o recurso.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Este método envia um buffer de dados para um recurso. O buffer de dados é enviado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads. Os dados não são codificados. Para receber notificações quando o carregamento dos dados terminar, adicione um gestor de eventos ao UploadDataCompleted evento.
Este método não bloqueia a thread que chama enquanto os dados estão a ser enviados. Para enviar dados e bloquear enquanto espera a resposta do servidor, use um dos UploadData 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.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
Aplica-se a
UploadDataAsync(Uri, Byte[])
Carrega um buffer de dados para um recurso identificado por um URI, usando o método POST. Este método não bloqueia o thread que chama.
public:
void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);public void UploadDataAsync(Uri address, byte[] data);member this.UploadDataAsync : Uri * byte[] -> unitPublic Sub UploadDataAsync (address As Uri, data As Byte())Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
- data
- Byte[]
O buffer de dados para enviar ao recurso.
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
-ou-
Não houve resposta do servidor que hospedava o recurso.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Este método envia um buffer de dados para um recurso. O buffer de dados é enviado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads. Os dados não são codificados. Para receber notificações quando o carregamento dos dados terminar, adicione um gestor de eventos ao UploadDataCompleted evento.
Este método não bloqueia a thread que chama enquanto os dados estão a ser enviados. Para enviar dados e bloquear enquanto espera a resposta do servidor, use um dos UploadData 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.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
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 UploadData(Uri, Byte[]).