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. Result Görev nesnesindeki özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresidirnull.

-veya-

data parametresidirnull.

WebException

birleştirilerek BaseAddressaddress 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

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, 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, yöntemini çağırarak CancelAsync tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

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

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İ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. Result Görev nesnesindeki özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresidirnull.

-veya-

data parametresidirnull.

WebException

birleştirilerek BaseAddressaddress 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

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, 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, yöntemini çağırarak CancelAsync tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

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

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İ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. Result Görev nesnesindeki özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresidirnull.

-veya-

data parametresidirnull.

WebException

birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

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

Açıklamalar

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, 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, yöntemini çağırarak CancelAsync tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

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

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İ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. Result Görev nesnesinde özelliği, sunucu tarafından gönderilen yanıtı içeren bir String döndürür.

Özel durumlar

ArgumentNullException

address parametresidirnull.

-veya-

data parametresidirnull.

WebException

birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

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

Açıklamalar

Bu işlem engellemez. Dize kaynağa yüklendikten sonra döndürülen Task<TResult> nesne 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, yöntemini çağırarak CancelAsync tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

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

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.