WebClient.OpenReadTaskAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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'si.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, bir Stream kaynaktan veri okumak için kullanılan bir döndürür.
- Öznitelikler
Özel durumlar
address
parametresidirnull
.
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 işlem engellemez. Döndürülen Task<TResult> nesne, 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, 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.
Not
Sistem kaynaklarının dolmasını önlemek için ile Stream işiniz bittiğinde öğesini çağırmalısınızStream.Close.
.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 address
eklenir.
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'te Ağ İ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'si.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, bir Stream kaynaktan veri okumak için kullanılan bir döndürür.
- Öznitelikler
Özel durumlar
address
parametresidirnull
.
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 işlem engellemez. Döndürülen Task<TResult> nesne, 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, 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.
Not
Sistem kaynaklarının dolmasını önlemek için ile Stream işiniz bittiğinde öğesini çağırmalısınızStream.Close.
.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 address
eklenir.
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'te Ağ İzleme.
Ayrıca bkz.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin