WebClient.UploadFileAsync Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Net
Bütünleştirilmiş Kod:
System.Net.WebClient.dll
Bütünleştirilmiş Kod:
System.dll
Bütünleştirilmiş Kod:
netstandard.dll

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

Aşırı Yüklemeler

UploadFileAsync(Uri, String)

POST yöntemini kullanarak belirtilen yerel dosyayı belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadFileAsync(Uri, String, String)

POST yöntemini kullanarak belirtilen yerel dosyayı belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.
UploadFileAsync(Uri, String, String, Object)

POST yöntemini kullanarak belirtilen yerel dosyayı belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

UploadFileAsync(Uri, String)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

POST yöntemini kullanarak belirtilen yerel dosyayı belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ fileName);
public void UploadFileAsync (Uri address, string fileName);
member this.UploadFileAsync : Uri * string -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)

Parametreler

address
Uri

Dosyayı alacak kaynağın URI'sini. 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.

fileName
String

Kaynağa gönderilecek dosya.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

fileName parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

fileName null, Empty, geçersiz karakter içeriyor veya belirtilen dosya yolu yok.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgisi multipartile başlar.

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.

Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Dosya karşıya yükleme tamamlandığında bildirim almak için UploadFileCompleted olayına bir olay işleyicisi ekleyin.

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

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

BaseAddress özelliği boş bir dize ("") değilse, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İ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ı yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, UploadFile(Uri, String)tarafından oluşan özel durumlara bakın.

Şunlara uygulanır

UploadFileAsync(Uri, String, String)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

POST yöntemini kullanarak belirtilen yerel dosyayı belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public void UploadFileAsync (Uri address, string? method, string fileName);
public void UploadFileAsync (Uri address, string method, string fileName);
member this.UploadFileAsync : Uri * string * string -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String)

Parametreler

address
Uri

Dosyayı alacak kaynağın URI'sini. 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

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

fileName
String

Kaynağa gönderilecek dosya.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

fileName parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

fileName null, Empty, geçersiz karakter içeriyor veya belirtilen dosya yolu yok.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgisi multipartile başlar.

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.

Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Dosya karşıya yükleme tamamlandığında bildirim almak için UploadFileCompleted olayına bir olay işleyicisi ekleyin.

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

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

BaseAddress özelliği boş bir dize ("") değilse, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İ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ı yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, UploadFile(Uri, String, String)tarafından oluşan özel durumlara bakın.

Şunlara uygulanır

UploadFileAsync(Uri, String, String, Object)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

POST yöntemini kullanarak belirtilen yerel dosyayı belirtilen kaynağa yükler. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);
public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);
public void UploadFileAsync (Uri address, string method, string fileName, object userToken);
member this.UploadFileAsync : Uri * string * string * obj -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)

Parametreler

address
Uri

Dosyayı alacak kaynağın URI'sini. 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

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

fileName
String

Kaynağa gönderilecek dosya.

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.

-veya-

fileName parametresi null.

WebException

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

fileName null, Empty, geçersiz karakter içeriyor veya belirtilen dosya yolu yok.

-veya-

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

-veya-

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

-veya-

Content-type üst bilgisi multipartile başlar.

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.

Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir. Dosya karşıya yükleme tamamlandığında bildirim almak için UploadFileCompleted olayına bir olay işleyicisi ekleyin.

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

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

BaseAddress özelliği boş bir dize ("") değilse, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İzleme.

Şunlara uygulanır