PipeStream.ReadAsync 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.
Aşırı Yüklemeler
| ReadAsync(Memory<Byte>, CancellationToken) |
Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt bellek aralığına yazar, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Geçerli akıştan bayt dizisini zaman uyumsuz olarak okur, belirtilen sayıda bayt için belirtilen konumdan başlayarak bayt dizisine okur, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler. |
ReadAsync(Memory<Byte>, CancellationToken)
- Kaynak:
- PipeStream.Unix.cs
- Kaynak:
- PipeStream.Unix.cs
- Kaynak:
- PipeStream.Unix.cs
Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt bellek aralığına yazar, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler.
public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parametreler
- cancellationToken
- CancellationToken
İptal istekleri için izlenecek belirteç. None varsayılan değerdir.
Döndürülenler
Zaman uyumsuz okuma işlemini temsil eden görev. özelliğinin Result değeri arabelleğe okunan toplam bayt sayısını içerir. Sonuç değeri, şu anda kullanılabilir sayıda bayt yoksa arabellekte ayrılan bayt sayısından az veya akışın sonuna ulaşıldıysa 0 (sıfır) olabilir.
Özel durumlar
Akış okumayı desteklemiyor.
Kapalı kanala erişilemiyor.
Boru henüz bağlanmadı.
-veya-
Boru bağlantısı kesilmiş durumda.
-veya-
Boru tutamacı ayarlanmadı. (Uygulamanız çağrı InitializeHandle(SafePipeHandle, Boolean, Boolean)yaptı mıPipeStream?
İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.
Açıklamalar
yöntemi, ReadAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanızın çalışmıyormuş gibi görünmesini sağlayabildiği uygulamalarda bu performansla ilgili dikkat edilmesi gerekenler özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.
CanRead Geçerli örneğin okumayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.
İşlem tamamlanmadan iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledStatus değerini içerir.
Şunlara uygulanır
ReadAsync(Byte[], Int32, Int32, CancellationToken)
- Kaynak:
- PipeStream.Unix.cs
- Kaynak:
- PipeStream.Unix.cs
- Kaynak:
- PipeStream.Unix.cs
Geçerli akıştan bayt dizisini zaman uyumsuz olarak okur, belirtilen sayıda bayt için belirtilen konumdan başlayarak bayt dizisine okur, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler.
public:
override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)Parametreler
- buffer
- Byte[]
Verileri yazacak arabellek.
- offset
- Int32
Akıştan veri yazmaya başlayabileceğiniz bayt uzaklığı buffer .
- count
- Int32
Okunacak bayt sayısı üst sınırı.
- cancellationToken
- CancellationToken
İptal istekleri için izlenecek belirteç. None varsayılan değerdir.
Döndürülenler
Zaman uyumsuz okuma işlemini temsil eden görev. özelliğinin Result değeri arabelleğe okunan toplam bayt sayısını içerir. Şu anda kullanılabilir durumdaki bayt sayısı istenen sayıdan küçükse sonuç değeri istenen bayt sayısından küçük veya akışın sonuna ulaşıldıysa 0 (sıfır) olabilir.
Özel durumlar
Akış okumayı desteklemiyor.
Kapalı kanala erişilemiyor.
Boru henüz bağlanmadı.
-veya-
Boru bağlantısı kesilmiş durumda.
-veya-
Boru tutamacı ayarlanmadı. (Uygulamanız çağrı InitializeHandle(SafePipeHandle, Boolean, Boolean)yaptı mıPipeStream?
İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.
Açıklamalar
yöntemi, ReadAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanızın çalışmıyormuş gibi görünmesini sağlayabildiği uygulamalarda bu performansla ilgili dikkat edilmesi gerekenler özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.
CanRead Geçerli örneğin okumayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.
İşlem tamamlanmadan iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledStatus değerini içerir.
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 Read(Byte[], Int32, Int32)özel durumlara bakın.
