WebClient.UploadDataAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

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

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 bir URI tarafından tanımlanan kaynağa veri arabelleği yükler.
UploadDataAsync(Uri, Byte[])	POST yöntemini kullanarak bir URI tarafından tanımlanan 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 parametresidirnull.

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

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. Veriler karşıya yüklendiğinde 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 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'da Ağ İzleme.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan UploadData(Uri, String, Byte[])özel durumlara bakın.

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

Kaynak:

WebClient.cs

Belirtilen yöntemi kullanarak ve belirteci tanımlayarak bir URI tarafından tanımlanan 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 parametresidirnull.

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

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. Veriler karşıya yüklendiğinde 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 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'da Ağ İzleme.

UploadDataAsync(Uri, Byte[])

Kaynak:

WebClient.cs

POST yöntemini kullanarak bir URI tarafından tanımlanan 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 parametresidirnull.

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

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. Veriler karşıya yüklendiğinde 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 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.

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

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

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan UploadData(Uri, Byte[])özel durumlara bakın.