XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) 메서드

정의

콘텐츠를 읽고 BinHex 디코딩된 이진 바이트를 반환합니다.

public:
 virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);
abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overridable Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

매개 변수

buffer
Byte[]

결과 텍스트를 복사해 넣을 버퍼입니다. 이 값은 null일 수 없습니다.

index
Int32

버퍼에 넣을 결과 복사가 시작되는 오프셋입니다.

count
Int32

버퍼에 복사할 최대 바이트 수입니다. 복사된 실제 바이트 수가 이 메서드에서 반환됩니다.

반환

버퍼에 쓴 바이트 수입니다.

예외

buffer 값이 null입니다.

ReadContentAsBinHex(Byte[], Int32, Int32)가 현재 노드에서 지원되지 않습니다.

또는

이전 비동기 작업이 완료되기 전에 XmlReader 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

버퍼 내의 인덱스 또는 인덱스와 개수를 합한 값이 할당된 버퍼 크기보다 큰 경우

구현된 XmlReader에서 이 메서드를 지원하지 않는 경우

설명

이 메서드는 콘텐츠를 스트리밍하고, 콘텐츠를 디코딩 BinHex 하고, 디코딩된 이진 바이트(예: 인라인 BinHex 으로 인코딩된 GIF 이미지)를 버퍼에 반환합니다. 이 메서드를 연속적으로 호출하여 포함된 텍스트의 큰 스트림을 읽을 수 있습니다.

참고

메서드가 값을 0반환할 때까지 메서드 호출 ReadContentAsBinHex 간에 판독기 속성에 액세스해서는 안 됩니다.

이 메서드의 동작은 다음과 같습니다.

  • ReadContentAsBinHex 는 작동하던 바이트 스트림의 끝에 도달했을 때 값을 0 반환합니다. 판독기는 첫 번째 비콘텐츠 노드에 배치됩니다.

  • 스트림에 남아 있는 것보다 더 적은 바이트 또는 정확한 바이트를 요청하는 경우 판독기는 현재 위치에 유지됩니다.

  • ReadContentAsBinHex는 다음 XML 노드 형식에서 지원되지 않습니다. Element, , XmlDeclaration, DocumentNone, DocumentType, , Notation, Entity, DocumentFragment.

이 메서드의 비동기 버전은 를 참조하세요 ReadContentAsBinHexAsync.

적용 대상

추가 정보