WebClient.UploadValuesAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Belirtilen ad/değer koleksiyonunu belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

Name	Description
UploadValuesAsync(Uri, NameValueCollection)	Belirtilen ad/değer koleksiyonundaki verileri, belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadValuesAsync(Uri, String, NameValueCollection)	Belirtilen ad/değer koleksiyonundaki verileri belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadValuesAsync(Uri, String, NameValueCollection, Object)	Belirtilen ad/değer koleksiyonundaki verileri belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez ve çağıranın işlem tamamlandığında çağrılan yönteme bir nesne geçirmesine izin verir.

UploadValuesAsync(Uri, NameValueCollection)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonundaki verileri, belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync(Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Parametreler

address

Uri

Koleksiyonu alacak kaynağın URI'sini. Bu URI, varsayılan yöntemle gönderilen bir isteği kabul edebilen bir kaynağı tanımlamalıdır.

data

NameValueCollection

NameValueCollection Kaynağa gönderilecek.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

data parametresi null'dir.

WebException

Birleştirilerek BaseAddressaddress 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 yöntem kaynağa bir dize gönderir. Dize, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Bu yöntem, dizeyi karşıya yüklemeden önce özelliğinde belirtilen kodlamayı kullanarak bir Byte diziye Encoding dönüştürür. Dize karşıya yükleme tamamlandığında bildirim almak için olaya bir olay işleyicisi UploadStringCompleted ekleyebilirsiniz.

Bu yöntem, dize gönderilirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken bir dize ve blok göndermek için yöntemlerden birini UploadString 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 UploadValues(Uri, NameValueCollection)oluşan özel durumlara bakın.

UploadValuesAsync(Uri, String, NameValueCollection)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonundaki verileri belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Parametreler

address

Uri

Koleksiyonu alacak kaynağın URI'sini. Bu URI, yöntemiyle method gönderilen bir isteği kabul edebilen bir kaynağı tanımlamalıdır.

method

String

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

data

NameValueCollection

NameValueCollection Kaynağa gönderilecek.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

data parametresi null'dir.

WebException

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

-veya-

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

-veya-

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

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, içinde NameValueCollectionaddress yer alan verileri kaynağa gönderir. Form verilerini işlenmek üzere bir URI'ye göndermek için bu yöntemi kullanın. Veriler form urlencoded medya türü kullanılarak gönderilir; content-Type üst bilgi değeri "application/x-www-form-urlencoded" olarak ayarlanmalıdır. Üst bilgi varsayılan olarak doğru ayarlanmıştır. Bu yöntemi koleksiyonda UploadValuesAsyncHeaders ayarlanmış farklı bir Content-Type üst bilgi değeriyle çağırırsanız yöntemler bir WebException oluşturur.

method Yöntem sunucu tarafından anlaşılmıyorsa, ne olduğunu temel protokol sınıfları belirler. Genellikle, hata belirtmek Status için özelliği ayarlanmış bir WebException oluşturulur.

, NameValueCollection iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Karşıya yükleme işlemi tamamlandığında bildirim almak için olaya bir olay işleyicisi UploadValuesCompleted ekleyin.

Bu yöntem, dize gönderilirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken bir dize ve blok göndermek için yöntemlerden birini UploadValues 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ş 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 UploadValues(Uri, String, NameValueCollection)oluşan özel durumlara bakın.

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Kaynak:

WebClient.cs

Belirtilen ad/değer koleksiyonundaki verileri belirtilen yöntemi kullanarak belirtilen URI tarafından tanımlanan kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez ve çağıranın işlem tamamlandığında çağrılan yönteme bir nesne geçirmesine izin verir.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);

public void UploadValuesAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Parametreler

address

Uri

Koleksiyonu alacak kaynağın URI'sini. Bu URI, yöntemiyle method gönderilen bir isteği kabul edebilen bir kaynağı tanımlamalıdır.

method

String

Dizeyi 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

NameValueCollection

NameValueCollection Kaynağa gönderilecek.

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.

-veya-

data parametresi null'dir.

WebException

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

-veya-

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

-veya-

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

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, içinde NameValueCollectionaddress yer alan verileri kaynağa gönderir. Form verilerini işlenmek üzere bir URI'ye göndermek için bu yöntemi kullanın. Veriler form urlencoded medya türü kullanılarak gönderilir; content-Type üst bilgi değeri "application/x-www-form-urlencoded" olarak ayarlanmalıdır. Üst bilgi varsayılan olarak doğru ayarlanmıştır. Bu yöntemi koleksiyonda UploadValuesAsyncHeaders ayarlanmış farklı bir Content-Type üst bilgi değeriyle çağırırsanız yöntemler bir WebException oluşturur.

method Yöntem sunucu tarafından anlaşılmıyorsa, ne olduğunu temel protokol sınıfları belirler. Genellikle, hata belirtmek Status için özelliği ayarlanmış bir WebException oluşturulur.

, NameValueCollection iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Karşıya yükleme işlemi tamamlandığında bildirim almak için olaya bir olay işleyicisi UploadValuesCompleted ekleyin.

Bu yöntem, dize gönderilirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken bir dize ve blok göndermek için yöntemlerden birini UploadValues 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ş 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.