WebClient.UploadStringTaskAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

UploadStringTaskAsync(Uri, String, String)	Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.
UploadStringTaskAsync(String, String, String)	Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.
UploadStringTaskAsync(String, String)	Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.
UploadStringTaskAsync(Uri, String)	Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.

UploadStringTaskAsync(Uri, String, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.

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);

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)

Parametreler

address

Uri

Dizeyi alacak kaynağın URI'si. HTTP kaynakları için, bu URI'nin betik veya ASP sayfası gibi POST yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlaması gerekir.

method

String

Dosyayı kaynağa göndermek için kullanılan HTTP yöntemi. Null ise, varsayılan değer http için POST ve ftp için STOR'dır.

data

String

Karşıya yüklenecek dize.

Döndürülenler

Task<String>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

method içerik göndermek için kullanılamaz.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, dize kaynağa yüklendikten sonra tamamlanır. Dize, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.NET Framework ve .NET Core 1.0'da, CancelAsync yöntemini çağırarak tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

Bu yöntem, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

UploadStringTaskAsync(String, String, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.

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);

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)

Parametreler

address

String

Dizeyi alacak kaynağın URI'si. HTTP kaynakları için, bu URI'nin betik veya ASP sayfası gibi POST yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlaması gerekir.

method

String

Dosyayı kaynağa göndermek için kullanılan HTTP yöntemi. Null ise, varsayılan değer http için POST ve ftp için STOR'dır.

data

String

Karşıya yüklenecek dize.

Döndürülenler

Task<String>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

method içerik göndermek için kullanılamaz.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, dize kaynağa yüklendikten sonra tamamlanır. Dize, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.NET Framework ve .NET Core 1.0'da, CancelAsync yöntemini çağırarak tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

Bu yöntem, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

UploadStringTaskAsync(String, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.

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);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Parametreler

address

String

Dizeyi alacak kaynağın URI'si. HTTP kaynakları için, bu URI'nin betik veya ASP sayfası gibi POST yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlaması gerekir.

data

String

Karşıya yüklenecek dize.

Döndürülenler

Task<String>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, dize kaynağa yüklendikten sonra tamamlanır. Dize, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.NET Framework ve .NET Core 1.0'da, CancelAsync yöntemini çağırarak tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

Bu yöntem, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

UploadStringTaskAsync(Uri, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi, bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak belirtilen kaynağa yükler.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of String)

Parametreler

address

Uri

Dizeyi alacak kaynağın URI'si. HTTP kaynakları için, bu URI'nin betik veya ASP sayfası gibi POST yöntemiyle gönderilen bir isteği kabul edebilen bir kaynağı tanımlaması gerekir.

data

String

Karşıya yüklenecek dize.

Döndürülenler

Task<String>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

data parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, dize kaynağa yüklendikten sonra tamamlanır. Dize, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.NET Framework ve .NET Core 1.0'da, CancelAsync yöntemini çağırarak tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

Bu yöntem, dizeyi karşıya yüklemeden önce Encoding özelliğinde belirtilen kodlamayı kullanarak bir Byte dizisine dönüştürür. Bu yöntem, dize iletilirken engeller.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.