XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) 메서드

정의

네임스페이스:

System.Xml

어셈블리:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReaderAsync.cs

XML 문서에 포함된 큰 텍스트 스트림을 비동기적으로 읽습니다.

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[]

텍스트 내용이 기록되는 버퍼 역할을 하는 문자의 배열입니다. 이 값은 null일 수 없습니다.

index

Int32

결과를 복사하기 시작할 수 있는 버퍼 내의 XmlReader 오프셋입니다.

count

Int32

버퍼에 복사할 최대 문자 수입니다. 복사된 실제 문자 수는 이 메서드에서 반환됩니다.

반환

Task<Int32>

버퍼로 읽은 문자 수입니다. 텍스트 콘텐츠가 더 이상 없으면 값 0이 반환됩니다.

예외

InvalidOperationException

XmlReader 이전 비동기 작업이 완료되기 전에 메서드가 호출되었습니다. 이 경우 InvalidOperationException "비동기 작업이 이미 진행 중입니다."라는 메시지와 함께 throw됩니다.

플래그true를 XmlReader .로 설정하지 않고 비동기 메서드를 호출했습니다Async. 이 경우 InvalidOperationException "Async 메서드를 사용하려는 경우 XmlReaderSettings.Async를 true로 설정"이라는 메시지와 함께 throw됩니다.

설명

동일한 기능을 가진 비동기 버전 ReadValueChunk입니다. 이 메서드를 사용하려면 플래그true를 .로 Async 설정해야 합니다.

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ReadValueChunk(Char[], Int32, Int32)throw된 예외를 참조하세요.

추가 정보

• 비동기 프로그래밍(C#)
• Async 및 Await를 사용한 비동기 프로그래밍(Visual Basic)