WebClient.OpenReadAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Belirtilen kaynağı içeren okunabilir bir akış açar. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

OpenReadAsync(Uri)	Belirtilen kaynağı içeren okunabilir bir akış açar. Bu yöntem çağıran iş parçacığını engellemez.
OpenReadAsync(Uri, Object)	Belirtilen kaynağı içeren okunabilir bir akış açar. Bu yöntem çağıran iş parçacığını engellemez.

OpenReadAsync(Uri)

Kaynak:

WebClient.cs

Belirtilen kaynağı içeren okunabilir bir akış açar. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync (Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

Parametreler

address

Uri

Alınacak kaynağın URI'sini.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

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 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. Akış kullanılabilir olduğunda bildirim almak için OpenReadCompleted olayına bir olay işleyicisi ekleyin.

Not

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

Bu yöntem, akış açılırken çağıran iş parçacığını engellemez. Akışı beklerken engellemek için OpenReadAsync yöntemini 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 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.

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, OpenRead(Uri)tarafından oluşan özel durumlara bakın.

OpenReadAsync(Uri, Object)

Kaynak:

WebClient.cs

Belirtilen kaynağı içeren okunabilir bir akış açar. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);

public void OpenReadAsync (Uri address, object? userToken);

member this.OpenReadAsync : Uri * obj -> unit

Public Sub OpenReadAsync (address As Uri, userToken As Object)

Parametreler

address

Uri

Alınacak kaynağın URI'sini.

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.

WebException

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 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. Akış kullanılabilir olduğunda bildirim almak için OpenReadCompleted olayına bir olay işleyicisi ekleyin.

Not

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

Bu yöntem, akış açılırken çağıran iş parçacığını engellemez. Akışı beklerken engellemek için OpenRead yöntemini 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 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.