WebClient.UploadStringAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

UploadStringAsync(Uri, String)	Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadStringAsync(Uri, String, String)	Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadStringAsync(Uri, String, String, Object)	Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

UploadStringAsync(Uri, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ data);

public void UploadStringAsync (Uri address, string data);

member this.UploadStringAsync : Uri * string -> unit

Public Sub UploadStringAsync (address As Uri, data As 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.

Ö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 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 işlemi 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 birleştirilen BaseAddress 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, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan UploadString(Uri, String)özel durumlara bakın.

UploadStringAsync(Uri, String, String)

Kaynak:

WebClient.cs

Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public void UploadStringAsync (Uri address, string? method, string data);

member this.UploadStringAsync : Uri * string * string -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As 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.

Ö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 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 işlemi 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 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'da Ağ İzleme.

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

UploadStringAsync(Uri, String, String, Object)

Kaynak:

WebClient.cs

Belirtilen dizeyi belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);

public void UploadStringAsync (Uri address, string? method, string data, object? userToken);

member this.UploadStringAsync : Uri * string * string * obj -> unit

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

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.

userToken

Object

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

Ö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 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 işlemi 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 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'da Ağ İzleme.