StringReader.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 konumdan başlayarak giriş dizesinden tüm karakterleri zaman uyumsuz olarak okur ve geçerli konumu giriş dizesinin sonuna ilerler.
ReadBlockAsync(Char[], Int32, Int32)	Geçerli dizeden belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve belirtilen dizinden başlayarak verileri arabelleğe yazar.

ReadBlockAsync(Memory<Char>, CancellationToken)

Kaynak:

StringReader.cs

Geçerli konumdan başlayarak giriş dizesinden tüm karakterleri zaman uyumsuz olarak okur ve geçerli konumu giriş dizesinin sonuna ilerler.

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

buffer

Memory<Char>

Bu yöntem döndürdüğünde, geçerli kaynaktan okunan karakterleri içerir. Okunan toplam karakter sayısı sıfırsa, yayılma değişmeden kalır.

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 görev. parametresinin TResult değeri arabelleğe okunan toplam karakter sayısını içerir.

Özel durumlar

OperationCanceledException

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

Açıklamalar

ReadBlockAsync(Memory<Char>, CancellationToken) zaman uyumsuz olarak çağırır ReadBlock(Span<Char>) ve bu da doğrudan çağrılar Read(Span<Char>) .

ReadBlockAsync(Char[], Int32, Int32)

Kaynak:

StringReader.cs

Geçerli dizeden belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve belirtilen dizinden başlayarak verileri 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);

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 en fazla karakter sayısı. Belirtilen sayıda karakter arabelleğe yazılmadan önce dizenin sonuna ulaşılırsa, 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. Şu anda kullanılabilir durumdaki bayt sayısı istenen sayıdan küçükse sonuç değeri istenen bayt sayısından küçük veya dizenin 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

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