WebClient.UploadFileTaskAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

Name	Description
UploadFileTaskAsync(Uri, String, String)	Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.
UploadFileTaskAsync(String, String, String)	Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.
UploadFileTaskAsync(String, String)	Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.
UploadFileTaskAsync(Uri, String)	Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.

UploadFileTaskAsync(Uri, String, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(Uri address, string? method, string fileName);

member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

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. ise null, varsayılan değer http için POST ve ftp için STOR'dır.

fileName

String

Kaynağa gönderilecek yerel dosya.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizi döndürür.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

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

-veya-

fileName is null, is 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 bilgi ile multipartbaş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.

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, dosya kaynağa yüklendikten sonra tamamlanır. Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.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, 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.

Varsayılan olarak, 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.

UploadFileTaskAsync(String, String, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(string address, string? method, string fileName);

member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

Parametreler

address

String

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. ise null, varsayılan değer http için POST ve ftp için STOR'dır.

fileName

String

Kaynağa gönderilecek yerel dosya.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizi döndürür.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

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

-veya-

fileName is null, is 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 bilgi ile multipartbaş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.

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, dosya kaynağa yüklendikten sonra tamamlanır. Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.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, 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.

Varsayılan olarak, 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.

UploadFileTaskAsync(String, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(string address, string fileName);

member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

Parametreler

address

String

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 yerel dosya.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizi döndürür.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

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

-veya-

fileName is null, is 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 bilgi ile multipartbaş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.

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, dosya kaynağa yüklendikten sonra tamamlanır. Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.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, 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

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.

UploadFileTaskAsync(Uri, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak kaynağa yükler.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(Uri address, string fileName);

member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

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 yerel dosya.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizi döndürür.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

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

-veya-

fileName is null, is 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 bilgi ile multipartbaş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.

Bu işlem engellenmez. Döndürülen Task<TResult> nesne, dosya kaynağa yüklendikten sonra tamamlanır. Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak gönderilir.

.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, 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

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.