StreamReader.ReadBlockAsync 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
| ReadBlockAsync(Memory<Char>, CancellationToken) |
Geçerli akıştan karakterleri zaman uyumsuz olarak okur ve verileri arabelleğe yazar. |
| ReadBlockAsync(Char[], Int32, Int32) |
Geçerli akıştan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve verileri belirtilen dizinden başlayarak bir arabelleğe yazar. |
ReadBlockAsync(Memory<Char>, CancellationToken)
- Kaynak:
- StreamReader.cs
- Kaynak:
- StreamReader.cs
- Kaynak:
- StreamReader.cs
Geçerli akıştan karakterleri zaman uyumsuz olarak okur ve verileri arabelleğe yazar.
public override System.Threading.Tasks.ValueTask<int> ReadBlockAsync (Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Overrides Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parametreler
Bu yöntem döndürdüğünde, geçerli kaynaktan okunan karakterlerle değiştirilen belirtilen karakter bellek bloğunu içerir.
- cancellationToken
- CancellationToken
İptal isteklerini izlemek için belirteç. None varsayılan değerdir.
Döndürülenler
Zaman uyumsuz okuma işlemini temsil eden bir değer görevi. Değer görevinin tür parametresinin değeri arabelleğe okunan toplam karakter sayısını içerir. Sonuç değeri, kullanılabilir durumdaki karakter sayısı istenen sayıdan küçükse istenen karakter sayısından az veya akışın sonuna ulaşıldıysa 0 (sıfır) olabilir.
Özel durumlar
İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.
Şunlara uygulanır
ReadBlockAsync(Char[], Int32, Int32)
- Kaynak:
- StreamReader.cs
- Kaynak:
- StreamReader.cs
- Kaynak:
- StreamReader.cs
Geçerli akıştan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve verileri belirtilen dizinden başlayarak bir arabelleğe yazar.
public:
override System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);public override System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>Public Overrides Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)Parametreler
- buffer
- Char[]
Bu yöntem döndürdüğünde, ve (index + count - 1) arasındaki index değerlerin geçerli kaynaktan okunan karakterlerle değiştirdiği belirtilen karakter dizisini içerir.
- index
- Int32
Yazmaya başlayabileceğiniz konum buffer .
- count
- Int32
Okunacak karakter sayısı üst sınırı. Belirtilen sayıda karakter arabelleğe yazılmadan önce akışın sonuna ulaşılırsa, yöntem döndürür.
Döndürülenler
Zaman uyumsuz okuma işlemini temsil eden görev. parametresinin TResult değeri arabelleğe okunan toplam karakter sayısını içerir. Sonuç değeri, kullanılabilir durumdaki karakter sayısı istenen sayıdan küçükse istenen karakter sayısından az veya akışın sonuna ulaşıldıysa 0 (sıfır) olabilir.
- Öznitelikler
Özel durumlar
buffer, null değeridir.
index veya count negatiftir.
ve count toplamı index arabellek uzunluğundan daha büyüktür.
Akış atıldı.
Okuyucu şu anda önceki bir okuma işlemi tarafından kullanılıyor.
Açıklamalar
Parametre tarafından count belirtilen karakter sayısı okunana veya akışın sonuna ulaşılana kadar görev tamamlanmaz.
Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ReadBlock(Char[], Int32, Int32)özel durumlara bakın.
