Aracılığıyla paylaş


XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Yöntem

Tanım

XML belgesine eklenmiş büyük metin akışlarını zaman uyumsuz olarak okur.

public:
 virtual System::Threading::Tasks::Task<int> ^ ReadValueChunkAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task<int> ReadValueChunkAsync(char[] buffer, int index, int count);
abstract member ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
Public Overridable Function ReadValueChunkAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)

Parametreler

buffer
Char[]

Metin içeriğinin yazıldığı arabellek görevi görecek karakter dizisi. Bu değer olamaz null.

index
Int32

Arabelleğin XmlReader içindeki uzaklık, sonuçları kopyalamaya başlayabilir.

count
Int32

Arabelleğe kopyalanacak en fazla karakter sayısı. Kopyalanan gerçek karakter sayısı bu yöntemden döndürülür.

Döndürülenler

Arabelleğe okunan karakter sayısı. Sıfır değeri, artık metin içeriği olmadığında döndürülür.

Özel durumlar

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.veya-

XmlReader bayrağı trueolarak ayarlanmadan Async zaman uyumsuz bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Async Yöntemleri kullanmak istiyorsanız XmlReaderSettings.Async değerini true olarak ayarlayın" iletisiyle oluşturulur.

Açıklamalar

Bu, aynı işlevselliğe sahip zaman uyumsuz sürümüdür ReadValueChunk. Bu yöntemi kullanmak için bayrağını Async olarak trueayarlamanız gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ReadValueChunk(Char[], Int32, Int32)oluşan özel durumlara bakın.

Şunlara uygulanır

Ayrıca bkz.