WebClient.UploadFileTaskAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

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

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. nullise 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. Görev nesnesinde Result özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizisi döndürür.

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

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, 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, 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.

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 FrameworkAğ İ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. nullise 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. Görev nesnesinde Result özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizisi döndürür.

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

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, 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, 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.

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 FrameworkAğ İ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. Görev nesnesinde Result özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizisi döndürür.

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

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, 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, 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.

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. Görev nesnesinde Result özelliği, dosya karşıya yüklendiğinde kaynaktan alınan yanıtın gövdesini içeren bir Byte dizisi döndürür.

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

Bu işlem engellenmez. Döndürülen Task<TResult> nesnesi, 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, 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.