WebClient.UploadStringAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将指定的字符串上载到指定的资源。 这些方法不阻止调用线程。
重载
UploadStringAsync(Uri, String) |
将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。 |
UploadStringAsync(Uri, String, String) |
将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。 |
UploadStringAsync(Uri, String, String, Object) |
将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。 |
UploadStringAsync(Uri, String)
将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。
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
要上载的字符串。
例外
注解
此方法将字符串发送到资源。 字符串使用从线程池自动分配的线程资源异步发送。 在上传字符串之前,此方法使用 属性中指定的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)
将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);
public void UploadStringAsync (Uri address, string? method, 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 默认值为 POST,对于 ftp 默认值为 STOR。
- data
- String
要上载的字符串。
例外
注解
此方法将字符串发送到资源。 字符串使用从线程池自动分配的线程资源异步发送。 在上传字符串之前,此方法使用 属性中指定的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)
将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。
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);
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 默认值为 POST,对于 ftp 默认值为 STOR。
- data
- String
要上载的字符串。
- userToken
- Object
一个用户定义对象,此对象将传递给完成异步操作后所调用的方法。
例外
注解
此方法将字符串发送到资源。 字符串使用从线程池自动分配的线程资源异步发送。 在上传字符串之前,此方法使用 属性中指定的Encoding编码将其Byte转换为数组。 若要在字符串上传完成时接收通知,可以向 UploadStringCompleted 事件添加事件处理程序。
此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串并阻止,请使用 方法之 UploadString 一。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。
BaseAddress如果属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是一个相对 URI,与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将推出:在整个 2024 年,我们将逐步取消以“GitHub 问题”作为内容的反馈机制,并将其替换为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈