WebClient.UploadStringTaskAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Carrega a cadeia de caracteres especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. Esses métodos não bloqueiam o thread de chamada.
Sobrecargas
| UploadStringTaskAsync(Uri, String, String) |
Carrega a cadeia de caracteres especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
| UploadStringTaskAsync(String, String, String) |
Carrega a cadeia de caracteres especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
| UploadStringTaskAsync(String, String) |
Carrega a cadeia de caracteres especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
| UploadStringTaskAsync(Uri, String) |
Carrega a cadeia de caracteres especificada para o recurso especificado como uma operação assíncrona usando um objeto de tarefa. |
UploadStringTaskAsync(Uri, String, String)
Carrega a cadeia de caracteres 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);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)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
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 que receberá a cadeia de caracteres. Para recursos HTTP, esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método POST, como um script ou uma página ASP.
- method
- String
O método HTTP usado para enviar o arquivo para o recurso. Se for nulo, o padrão será POST para http e STOR para ftp.
- data
- String
A cadeia de caracteres a ser carregada.
Retornos
O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna uma String que contém a resposta enviada pelo servidor.
- Atributos
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
method não pode ser usado para enviar o conteúdo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que a cadeia de caracteres for carregada no recurso. A cadeia de caracteres é enviada de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads.
No .NET Framework e no .NET Core 1.0, você pode cancelar operações assíncronas que não foram concluídas chamando o CancelAsync método.
Antes de carregar a cadeia de caracteres, esse método converte-a em uma Byte matriz usando a codificação especificada na Encoding propriedade. Esse método bloqueia enquanto a cadeia de caracteres é transmitida.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que é combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede em .NET Framework.
Aplica-se a
UploadStringTaskAsync(String, String, String)
Carrega a cadeia de caracteres 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);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)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
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 que receberá a cadeia de caracteres. Para recursos HTTP, esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método POST, como um script ou uma página ASP.
- method
- String
O método HTTP usado para enviar o arquivo para o recurso. Se for nulo, o padrão será POST para http e STOR para ftp.
- data
- String
A cadeia de caracteres a ser carregada.
Retornos
O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna uma String que contém a resposta enviada pelo servidor.
- Atributos
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
method não pode ser usado para enviar o conteúdo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que a cadeia de caracteres for carregada no recurso. A cadeia de caracteres é enviada de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads.
No .NET Framework e no .NET Core 1.0, você pode cancelar operações assíncronas que não foram concluídas chamando o CancelAsync método.
Antes de carregar a cadeia de caracteres, esse método converte-a em uma Byte matriz usando a codificação especificada na Encoding propriedade. Esse método bloqueia enquanto a cadeia de caracteres é transmitida.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que é combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede em .NET Framework.
Aplica-se a
UploadStringTaskAsync(String, String)
Carrega a cadeia de caracteres 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);public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
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 que receberá a cadeia de caracteres. Para recursos HTTP, esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método POST, como um script ou uma página ASP.
- data
- String
A cadeia de caracteres a ser carregada.
Retornos
O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna uma String que contém a resposta enviada pelo servidor.
- Atributos
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que a cadeia de caracteres for carregada no recurso. A cadeia de caracteres é enviada de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads.
No .NET Framework e no .NET Core 1.0, você pode cancelar operações assíncronas que não foram concluídas chamando o CancelAsync método.
Antes de carregar a cadeia de caracteres, esse método converte-a em uma Byte matriz usando a codificação especificada na Encoding propriedade. Esse método bloqueia enquanto a cadeia de caracteres é transmitida.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que é combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede em .NET Framework.
Aplica-se a
UploadStringTaskAsync(Uri, String)
Carrega a cadeia de caracteres 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);public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
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 que receberá a cadeia de caracteres. Para recursos HTTP, esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método POST, como um script ou uma página ASP.
- data
- String
A cadeia de caracteres a ser carregada.
Retornos
O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna uma String que contém a resposta enviada pelo servidor.
- Atributos
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Comentários
Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que a cadeia de caracteres for carregada no recurso. A cadeia de caracteres é enviada de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads.
No .NET Framework e no .NET Core 1.0, você pode cancelar operações assíncronas que não foram concluídas chamando o CancelAsync método.
Antes de carregar a cadeia de caracteres, esse método converte-a em uma Byte matriz usando a codificação especificada na Encoding propriedade. Esse método bloqueia enquanto a cadeia de caracteres é transmitida.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que é combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede em .NET Framework.