WebClient.UploadStringTaskAsync Metodo

Definizione

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object. Questi metodi non bloccano il thread chiamante.These methods do not block the calling thread.

Overload

UploadStringTaskAsync(Uri, String, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(String, String, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(String, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

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)

Parametri

address
Uri

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

Il metodo HTTP utilizzato per inviare il file alla risorsa.The HTTP method used to send the file to the resource. Se il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

data
String

Stringa da caricare.The string to be uploaded.

Restituisce

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto String contenente la risposta inviata dal server.The Result property on the task object returns a String containing the response sent by the server.

Attributi

Eccezioni

Il valore del parametro address è null.The address parameter is null.

-oppure--or-

Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

-oppure--or-

Non è possibile utilizzare method per inviare contenuto.method cannot be used to send content.

-oppure--or-

Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L' Task<TResult> oggetto restituito viene completato dopo che la stringa è stata caricata nella risorsa.The returned Task<TResult> object will complete after the string has been uploaded to the resource. La stringa viene inviata in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Prima di caricare la stringa, questo metodo lo converte in una Byte matrice usando la codifica specificata nella Encoding Proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address .If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a

UploadStringTaskAsync(String, String, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

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)

Parametri

address
String

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

Il metodo HTTP utilizzato per inviare il file alla risorsa.The HTTP method used to send the file to the resource. Se il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

data
String

Stringa da caricare.The string to be uploaded.

Restituisce

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto String contenente la risposta inviata dal server.The Result property on the task object returns a String containing the response sent by the server.

Attributi

Eccezioni

Il valore del parametro address è null.The address parameter is null.

-oppure--or-

Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

-oppure--or-

Non è possibile utilizzare method per inviare contenuto.method cannot be used to send content.

-oppure--or-

Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L' Task<TResult> oggetto restituito viene completato dopo che la stringa è stata caricata nella risorsa.The returned Task<TResult> object will complete after the string has been uploaded to the resource. La stringa viene inviata in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Prima di caricare la stringa, questo metodo lo converte in una Byte matrice usando la codifica specificata nella Encoding Proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address .If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a

UploadStringTaskAsync(String, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

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)

Parametri

address
String

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String

Stringa da caricare.The string to be uploaded.

Restituisce

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto String contenente la risposta inviata dal server.The Result property on the task object returns a String containing the response sent by the server.

Attributi

Eccezioni

Il valore del parametro address è null.The address parameter is null.

-oppure--or-

Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

-oppure--or-

Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L' Task<TResult> oggetto restituito viene completato dopo che la stringa è stata caricata nella risorsa.The returned Task<TResult> object will complete after the string has been uploaded to the resource. La stringa viene inviata in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Prima di caricare la stringa, questo metodo lo converte in una Byte matrice usando la codifica specificata nella Encoding Proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address .If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a

UploadStringTaskAsync(Uri, String)

Carica la stringa specificata nella risorsa specificata come operazione asincrona utilizzando un oggetto attività.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

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)

Parametri

address
Uri

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String

Stringa da caricare.The string to be uploaded.

Restituisce

Task<String>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto String contenente la risposta inviata dal server.The Result property on the task object returns a String containing the response sent by the server.

Attributi

Eccezioni

Il valore del parametro address è null.The address parameter is null.

-oppure--or-

Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

-oppure--or-

Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L' Task<TResult> oggetto restituito viene completato dopo che la stringa è stata caricata nella risorsa.The returned Task<TResult> object will complete after the string has been uploaded to the resource. La stringa viene inviata in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Prima di caricare la stringa, questo metodo lo converte in una Byte matrice usando la codifica specificata nella Encoding Proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address .If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a