TextReader.ReadBlockAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

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 metin okuyucudan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve verileri belirtilen dizinden başlayarak arabelleğe yazar.

ReadBlockAsync(Memory<Char>, CancellationToken)

Kaynak:

TextReader.cs

Geçerli akıştan karakterleri zaman uyumsuz olarak okur ve verileri arabelleğe yazar.

public virtual System.Threading.Tasks.ValueTask<int> ReadBlockAsync (Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

abstract member ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overridable Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

buffer

Memory<Char>

Bu yöntem döndürdüğünde, geçerli kaynaktan okunan karakterlerle değiştirilen belirtilen bellek bloğunu içerir.

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask<Int32>

Zaman uyumsuz okuma işlemini temsil eden bir değer görevi. type 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 küçük veya akışın sonuna ulaşıldıysa 0 (sıfır) olabilir.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

ReadBlockAsync(Char[], Int32, Int32)

Kaynak:

TextReader.cs

Geçerli metin okuyucudan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve verileri belirtilen dizinden başlayarak arabelleğe yazar.

public:
 virtual System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);

abstract member ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>

Public Overridable 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 en fazla karakter sayısı. Belirtilen sayıda karakter arabelleğe okunmadan önce metnin sonuna ulaşılırsa, geçerli yöntem döndürür.

Döndürülenler

Task<Int32>

Zaman uyumsuz okuma işlemini temsil eden görev. parametresinin TResult değeri arabelleğe okunan toplam bayt sayısını içerir. Sonuç değeri, kullanılabilir durumdaki bayt sayısı istenen sayıdan küçükse istenen bayt sayısından küçük veya metnin sonuna ulaşıldıysa 0 (sıfır) olabilir.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

ArgumentOutOfRangeException

index veya count negatiftir.

ArgumentException

ve count toplamını index arabellek uzunluğundan daha büyük.

ObjectDisposedException

Metin okuyucu atıldı.

InvalidOperationException

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 metnin sonuna ulaşılana kadar görev tamamlanmaz.

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 ReadBlock(Char[], Int32, Int32)özel durumlara bakın.

Ayrıca bkz.

• ReadBlockAsync(Char[], Int32, Int32)
• ReadBlockAsync(Char[], Int32, Int32)
• Dosya ve Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir Dosyaya Metin Yazma