WebClient.UploadStringAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

将指定的字符串上传到指定的资源。 这些方法不会阻止调用线程。

重载

UploadStringAsync(Uri, String)	将指定的字符串上传到指定的资源。 此方法不会阻止调用线程。
UploadStringAsync(Uri, String, String)	将指定的字符串上传到指定的资源。 此方法不会阻止调用线程。
UploadStringAsync(Uri, String, String, Object)	将指定的字符串上传到指定的资源。 此方法不会阻止调用线程。

UploadStringAsync(Uri, String)

Source:

WebClient.cs

将指定的字符串上传到指定的资源。 此方法不会阻止调用线程。

public:
 void UploadStringAsync(Uri ^ address, System::String ^ data);

public void UploadStringAsync (Uri address, string data);

member this.UploadStringAsync : Uri * string -> unit

Public Sub UploadStringAsync (address As Uri, data As String)

参数

address

Uri

要接收字符串的资源的 URI。 对于 HTTP 资源，此 URI 必须标识一个资源，该资源可以接受使用 POST 方法发送的请求，例如脚本或 ASP 页。

data

String

要上传的字符串。

例外

ArgumentNullException

address 参数 null。

-或-

data 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

托管资源的服务器没有响应。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

此方法将字符串发送到资源。 该字符串使用从线程池自动分配的线程资源异步发送。 上传字符串之前，此方法使用 Encoding 属性中指定的编码将其转换为 Byte 数组。 若要在字符串上传完成后接收通知，可以将事件处理程序添加到 UploadStringCompleted 事件。

此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串和块，请使用 UploadString 方法之一。

在 .NET Framework 和 .NET Core 1.0 中，可以通过调用 CancelAsync 方法取消尚未完成的异步操作。

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。

此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，将使用 POST 方法。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 UploadString(Uri, String)引发的异常。

UploadStringAsync(Uri, String, String)

Source:

WebClient.cs

将指定的字符串上传到指定的资源。 此方法不会阻止调用线程。

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 -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String)

参数

address

Uri

要接收字符串的资源的 URI。 对于 HTTP 资源，此 URI 必须标识一个资源，该资源可以接受使用 POST 方法发送的请求，例如脚本或 ASP 页。

method

String

用于将文件发送到资源的 HTTP 方法。 如果为 null，则默认值为 HTTP 和 STOR for ftp。

data

String

要上传的字符串。

例外

ArgumentNullException

address 参数 null。

-或-

data 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

method 不能用于发送内容。

-或-

托管资源的服务器没有响应。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

此方法将字符串发送到资源。 该字符串使用从线程池自动分配的线程资源异步发送。 上传字符串之前，此方法使用 Encoding 属性中指定的编码将其转换为 Byte 数组。 若要在字符串上传完成后接收通知，可以将事件处理程序添加到 UploadStringCompleted 事件。

此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串和块，请使用 UploadString 方法之一。

在 .NET Framework 和 .NET Core 1.0 中，可以通过调用 CancelAsync 方法取消尚未完成的异步操作。

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 UploadString(Uri, String, String)引发的异常。

UploadStringAsync(Uri, String, String, Object)

Source:

WebClient.cs

将指定的字符串上传到指定的资源。 此方法不会阻止调用线程。

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 -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)

参数

address

Uri

要接收字符串的资源的 URI。 对于 HTTP 资源，此 URI 必须标识一个资源，该资源可以接受使用 POST 方法发送的请求，例如脚本或 ASP 页。

method

String

用于将文件发送到资源的 HTTP 方法。 如果为 null，则默认值为 HTTP 和 STOR for ftp。

data

String

要上传的字符串。

userToken

Object

在异步操作完成时传递给调用的方法的用户定义对象。

例外

ArgumentNullException

address 参数 null。

-或-

data 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

method 不能用于发送内容。

-或-

托管资源的服务器没有响应。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

此方法将字符串发送到资源。 该字符串使用从线程池自动分配的线程资源异步发送。 上传字符串之前，此方法使用 Encoding 属性中指定的编码将其转换为 Byte 数组。 若要在字符串上传完成后接收通知，可以将事件处理程序添加到 UploadStringCompleted 事件。

此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串和块，请使用 UploadString 方法之一。

在 .NET Framework 和 .NET Core 1.0 中，可以通过调用 CancelAsync 方法取消尚未完成的异步操作。

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。