WebClient.UploadDataAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

URI tarafından tanımlanan bir kaynağa veri arabelleği yükler. Bu yöntem çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

Name	Description
UploadDataAsync(Uri, String, Byte[])	Belirtilen yöntemi kullanarak URI tarafından tanımlanan bir kaynağa veri arabelleği yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadDataAsync(Uri, String, Byte[], Object)	Belirtilen yöntemi kullanarak ve belirteci tanımlayarak URI tarafından tanımlanan bir kaynağa veri arabelleği yükler.
UploadDataAsync(Uri, Byte[])	POST yöntemini kullanarak URI tarafından tanımlanan bir kaynağa veri arabelleği yükler. Bu yöntem çağıran iş parçacığını engellemez.

UploadDataAsync(Uri, String, Byte[])

Kaynak:

WebClient.cs

Belirtilen yöntemi kullanarak URI tarafından tanımlanan bir kaynağa veri arabelleği yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync(Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

Parametreler

address

Uri

Verileri alacak kaynağın URI'si.

method

String

Verileri kaynağa göndermek için kullanılan yöntem. ise null, varsayılan değer http için POST ve ftp için STOR'dır.

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

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

-veya-

Akış açılırken bir hata oluştu.

-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 yöntem bir kaynağa veri arabelleği gönderir. Veri arabelleği, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Veriler kodlanmaz. Veri karşıya yükleme işlemi tamamlandığında bildirim almak için olaya bir olay işleyicisi UploadDataCompleted ekleyin.

Bu yöntem, veriler gönderilirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken veri göndermek ve engellemek için yöntemlerden birini UploadData kullanın.

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

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak 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

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından UploadData(Uri, String, Byte[])oluşan özel durumlara bakın.

UploadDataAsync(Uri, String, Byte[], Object)

Kaynak:

WebClient.cs

Belirtilen yöntemi kullanarak ve belirteci tanımlayarak URI tarafından tanımlanan bir kaynağa veri arabelleği yükler.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync(Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

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

Parametreler

address

Uri

Verileri alacak kaynağın URI'si.

method

String

Verileri kaynağa göndermek için kullanılan yöntem. ise null, varsayılan değer http için POST ve ftp için STOR'dır.

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

userToken

Object

Zaman uyumsuz işlem tamamlandığında çağrılan yönteme geçirilen kullanıcı tanımlı nesne.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

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

-veya-

Akış açılırken bir hata oluştu.

-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 yöntem bir kaynağa veri arabelleği gönderir. Veri arabelleği, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Veriler kodlanmaz. Veri karşıya yükleme işlemi tamamlandığında bildirim almak için olaya bir olay işleyicisi UploadDataCompleted ekleyin.

Bu yöntem, veriler gönderilirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken veri göndermek ve engellemek için yöntemlerden birini UploadData kullanın.

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

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak 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

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

UploadDataAsync(Uri, Byte[])

Kaynak:

WebClient.cs

POST yöntemini kullanarak URI tarafından tanımlanan bir kaynağa veri arabelleği yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync(Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

Parametreler

address

Uri

Verileri alacak kaynağın URI'si.

data

Byte[]

Kaynağa gönderilecek veri arabelleği.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

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

-veya-

Akış açılırken bir hata oluştu.

-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 yöntem bir kaynağa veri arabelleği gönderir. Veri arabelleği, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Veriler kodlanmaz. Veri karşıya yükleme işlemi tamamlandığında bildirim almak için olaya bir olay işleyicisi UploadDataCompleted ekleyin.

Bu yöntem, veriler gönderilirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken veri göndermek ve engellemek için yöntemlerden birini UploadData kullanın.

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

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak 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.

Bu yöntem bir FTP kaynağını karşıya yüklemek için STOR komutunu kullanır. BIR HTTP kaynağı için POST yöntemi kullanılır.

Not

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından UploadData(Uri, Byte[])oluşan özel durumlara bakın.