WebClient.UploadStringTaskAsync 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 como uma operação assíncrona usando um objeto de tarefa. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| UploadStringTaskAsync(Uri, String, String) |
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
| UploadStringTaskAsync(String, String, String) |
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
| UploadStringTaskAsync(String, String) |
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
| UploadStringTaskAsync(Uri, String) |
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
UploadStringTaskAsync(Uri, String, String)
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync(Uri address, string method, string data);public System.Threading.Tasks.Task<string> UploadStringTaskAsync(Uri address, string method, string data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of 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.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve a String contendo a resposta enviada pelo servidor.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de a cadeia ter sido carregada para o recurso. A string é enviada de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Antes de carregar a cadeia, este método converte-a num Byte array usando a codificação especificada na Encoding propriedade. Este método bloqueia enquanto a corda é transmitida.
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
UploadStringTaskAsync(String, String, String)
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync(string address, string method, string data);public System.Threading.Tasks.Task<string> UploadStringTaskAsync(string address, string method, string data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)Parâmetros
- address
- String
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.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve a String contendo a resposta enviada pelo servidor.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de a cadeia ter sido carregada para o recurso. A string é enviada de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Antes de carregar a cadeia, este método converte-a num Byte array usando a codificação especificada na Encoding propriedade. Este método bloqueia enquanto a corda é transmitida.
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
UploadStringTaskAsync(String, String)
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync(string address, string data);public System.Threading.Tasks.Task<string> UploadStringTaskAsync(string address, string data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)Parâmetros
- address
- String
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.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve a String contendo a resposta enviada pelo servidor.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de a cadeia ter sido carregada para o recurso. A string é enviada de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Antes de carregar a cadeia, este método converte-a num Byte array usando a codificação especificada na Encoding propriedade. Este método bloqueia enquanto a corda é transmitida.
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
UploadStringTaskAsync(Uri, String)
Carrega a string especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync(Uri address, string data);public System.Threading.Tasks.Task<string> UploadStringTaskAsync(Uri address, string data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of 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.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve a String contendo a resposta enviada pelo servidor.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de a cadeia ter sido carregada para o recurso. A string é enviada de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Antes de carregar a cadeia, este método converte-a num Byte array usando a codificação especificada na Encoding propriedade. Este método bloqueia enquanto a corda é transmitida.
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.