WebClient.OpenReadTaskAsync Yöntem

Tanım

Bir görev nesnesi kullanarak belirtilen kaynağı zaman uyumsuz bir işlem olarak içeren okunabilir bir akış açar. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

OpenReadTaskAsync(String)

Bir görev nesnesi kullanarak belirtilen kaynağı zaman uyumsuz bir işlem olarak içeren okunabilir bir akış açar.

OpenReadTaskAsync(Uri)

Bir görev nesnesi kullanarak belirtilen kaynağı zaman uyumsuz bir işlem olarak içeren okunabilir bir akış açar.

OpenReadTaskAsync(String)

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

Bir görev nesnesi kullanarak belirtilen kaynağı zaman uyumsuz bir işlem olarak içeren okunabilir bir akış açar.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Parametreler

address
String

Alınacak kaynağın URI'sini.

Döndürülenler

Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, bir kaynaktan verileri okumak için kullanılan bir Stream döndürür.

Öznitelikler

Özel durumlar

address parametresi null.

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

-veya-

Kaynak indirilirken bir hata oluştu.

-veya-

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

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, veri kaynağına okunabilir bir akış açıldıktan sonra tamamlanır. Bu yöntem, akış açılırken çağıran iş parçacığını engellemez.

Bu yöntem, address parametresi tarafından belirtilen kaynağa erişmek için kullanılan bir Stream örneği alır. Akış, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak elde edilir.

Not

Sistem kaynaklarının tükenmesini önlemek için Stream bitirdiğinizde Stream.Close çağırmalısınız.

.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 ve address mutlak bir URI belirtmiyorsa, address istenen kaynağın mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği nulldeğilse, addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET 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.

Ayrıca bkz.

Şunlara uygulanır

OpenReadTaskAsync(Uri)

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

Bir görev nesnesi kullanarak belirtilen kaynağı zaman uyumsuz bir işlem olarak içeren okunabilir bir akış açar.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Parametreler

address
Uri

Alınacak kaynağın URI'sini.

Döndürülenler

Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, bir kaynaktan verileri okumak için kullanılan bir Stream döndürür.

Öznitelikler

Özel durumlar

address parametresi null.

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

-veya-

Kaynak indirilirken bir hata oluştu.

-veya-

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

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, veri kaynağına okunabilir bir akış açıldıktan sonra tamamlanır. Bu yöntem, akış açılırken çağıran iş parçacığını engellemez.

Bu yöntem, address parametresi tarafından belirtilen kaynağa erişmek için kullanılan bir Stream örneği alır. Akış, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak elde edilir.

Not

Sistem kaynaklarının tükenmesini önlemek için Stream bitirdiğinizde Stream.Close çağırmalısınız.

.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 ve address mutlak bir URI belirtmiyorsa, address istenen kaynağın mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği nulldeğilse, addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET 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.

Ayrıca bkz.

Şunlara uygulanır