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'si.

Özel durumlar

ArgumentNullException

address parametresidirnull.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

-veya-

Akışı açarken bir hata oluştu.

Açıklamalar

Bu yöntem, parametresi tarafından address 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 olaya bir olay işleyicisi OpenReadCompleted ekleyin.

Not

Sistem kaynaklarının dolmasını önlemek için ile Stream işiniz bittiğinde öğesini çağırmalısınızStream.Close.

Bu yöntem, akış açılırken çağıran iş parçacığını engellemez. Akışı beklerken engellemek için yöntemini kullanın OpenReadAsync .

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

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan OpenRead(Uri)ö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'si.

userToken

Object

Zaman uyumsuz işlem tamamlandığında çağrılan yöntemine geçirilen kullanıcı tanımlı nesne.

Özel durumlar

ArgumentNullException

address parametresidirnull.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

-veya-

Akışı açarken bir hata oluştu.

Açıklamalar

Bu yöntem, parametresi tarafından address 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 olaya bir olay işleyicisi OpenReadCompleted ekleyin.

Not

Sistem kaynaklarının dolmasını önlemek için ile Stream işiniz bittiğinde öğesini çağırmalısınızStream.Close.

Bu yöntem, akış açılırken çağıran iş parçacığını engellemez. Akışı beklerken engellemek için yöntemini kullanın OpenRead .

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

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.