WebClient.UploadValuesAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
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 nesnesi geçirmesine izin verir. |
UploadValuesAsync(Uri, NameValueCollection)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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'si. 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
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
Kaynağı barındıran sunucudan yanıt alınmadı.
Açıklamalar
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 UploadStringCompleted olaya bir olay işleyicisi 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 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 address
eklenir.
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 UploadValues(Uri, NameValueCollection)özel durumlara bakın.
Şunlara uygulanır
UploadValuesAsync(Uri, String, NameValueCollection)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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);
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'si. 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
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
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 UploadValuesAsync yöntemi koleksiyonda Headers ayarlanmış farklı bir Content-Type üst bilgi değeriyle çağırırsanız yöntemleri oluştururWebException.
method
Yöntem sunucu tarafından anlaşılamadıysa, 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 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ş değilse, öğesine address
eklenir.
Not
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'de 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 UploadValues(Uri, String, NameValueCollection)özel durumlara bakın.
Şunlara uygulanır
UploadValuesAsync(Uri, String, NameValueCollection, Object)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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 nesnesi 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);
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'si. 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
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
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 UploadValuesAsync yöntemi koleksiyonda Headers ayarlanmış farklı bir Content-Type üst bilgi değeriyle çağırırsanız yöntemleri oluştururWebException.
method
Yöntem sunucu tarafından anlaşılamadıysa, 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 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ş değilse, öğesine address
eklenir.
Not
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'de Ağ İzleme.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin