WebClient.UploadStringAsync 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 a string especificada para o recurso especificado. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| UploadStringAsync(Uri, String) |
Carrega a string especificada para o recurso especificado. Este método não bloqueia o thread que chama. |
| UploadStringAsync(Uri, String, String) |
Carrega a string especificada para o recurso especificado. Este método não bloqueia o thread que chama. |
| UploadStringAsync(Uri, String, String, Object) |
Carrega a string especificada para o recurso especificado. Este método não bloqueia o thread que chama. |
UploadStringAsync(Uri, String)
Carrega a string especificada para o recurso especificado. Este método não bloqueia o thread que chama.
public:
void UploadStringAsync(Uri ^ address, System::String ^ data);public void UploadStringAsync(Uri address, string data);member this.UploadStringAsync : Uri * string -> unitPublic Sub UploadStringAsync (address As Uri, data As String)Parâmetros
- address
- Uri
O URI do recurso a receber a cadeia. Para recursos HTTP, este URI deve identificar um recurso que possa aceitar um pedido enviado com o método POST, como um script ou página ASP.
- data
- String
A cadeia a carregar.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-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 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.
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 UploadString(Uri, String).
Aplica-se a
UploadStringAsync(Uri, String, String)
Carrega a string especificada para o recurso especificado. Este método não bloqueia o thread que chama.
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);public void UploadStringAsync(Uri address, string method, string data);member this.UploadStringAsync : Uri * string * string -> unitPublic Sub UploadStringAsync (address As Uri, method As String, data As String)Parâmetros
- address
- Uri
O URI do recurso a receber a cadeia. Para recursos HTTP, este URI deve identificar um recurso que possa aceitar um pedido enviado com o método POST, como um script ou página ASP.
- method
- String
O método HTTP usado para enviar o ficheiro para o recurso. Se for nulo, o padrão é POST para http e STOR para ftp.
- data
- String
A cadeia a carregar.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
method não pode ser usado para enviar conteúdo.
-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 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.
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 UploadString(Uri, String, String).
Aplica-se a
UploadStringAsync(Uri, String, String, Object)
Carrega a string especificada para o recurso especificado. Este método não bloqueia o thread que chama.
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);public void UploadStringAsync(Uri address, string method, string data, object userToken);member this.UploadStringAsync : Uri * string * string * obj -> unitPublic Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)Parâmetros
- address
- Uri
O URI do recurso a receber a cadeia. Para recursos HTTP, este URI deve identificar um recurso que possa aceitar um pedido enviado com o método POST, como um script ou página ASP.
- method
- String
O método HTTP usado para enviar o ficheiro para o recurso. Se for nulo, o padrão é POST para http e STOR para ftp.
- data
- String
A cadeia a carregar.
- userToken
- Object
Um objeto definido pelo utilizador que é passado para o método invocado quando a operação assíncrona termina.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
method não pode ser usado para enviar conteúdo.
-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 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.
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.