XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Method

정의

XML 문서에 포함된 큰 텍스트 스트림을 비동기적으로 읽습니다.Asynchronously reads large streams of text embedded in an XML document.

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)

매개 변수

buffer
Char[]

텍스트 콘텐츠를 쓸 버퍼 역할을 하는 문자 배열입니다.The array of characters that serves as the buffer to which the text contents are written. 이 값은 null일 수 없습니다.This value cannot be null.

index
Int32 Int32 Int32 Int32

XmlReader가 버퍼 내에서 결과 복사를 시작할 수 있는 오프셋입니다.The offset within the buffer where the XmlReader can start to copy the results.

count
Int32 Int32 Int32 Int32

버퍼에 복사할 최대 문자 수입니다.The maximum number of characters to copy into the buffer. 이 메서드는 복사된 실제 문자 수를 반환합니다.The actual number of characters copied is returned from this method.

반환

버퍼로 읽어온 문자 수입니다.The number of characters read into the buffer. 텍스트 콘텐츠가 더 이상 없으면 0이 반환됩니다.The value zero is returned when there is no more text content.

예외

이전 비동기 작업이 완료되기 전에 XmlReader 메서드가 호출되었습니다.An XmlReader method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress." 또는-or-

Async 플래그를 true로 설정하지 않고 XmlReader 비동기 메서드가 호출되었습니다.An XmlReader asynchronous method was called without setting the Async flag to true. 이 경우 “비동기 메서드를 사용하려면 XmlReaderSettings.Async를 true로 설정하세요.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods."

설명

비동기 버전이 ReadValueChunk, 동일한 기능을 사용 합니다.This is the asynchronous version of ReadValueChunk, with the same functionality. 이 메서드를 사용 하려면 설정 해야 합니다 Async 플래그를 true입니다.To use this method, you must set the Async flag to true.

적용 대상

추가 정보