XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Method

Definition

콘텐츠를 읽고 BinHex 디코딩된 이진 바이트를 반환합니다.Reads the content and returns the BinHex decoded binary bytes.

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

Parameters

buffer
Byte[]

결과 텍스트를 복사해 넣을 버퍼입니다.The buffer into which to copy the resulting text. 이 값은 null일 수 없습니다.This value cannot be null.

index
Int32

버퍼에 넣을 결과 복사가 시작되는 오프셋입니다.The offset into the buffer where to start copying the result.

count
Int32

버퍼에 복사할 최대 바이트 수입니다.The maximum number of bytes to copy into the buffer. 복사된 실제 바이트 수가 이 메서드에서 반환됩니다.The actual number of bytes copied is returned from this method.

Returns

Int32

버퍼에 쓴 바이트 수입니다.The number of bytes written to the buffer.

Exceptions

buffer 값이 null입니다.The buffer value is null.

ReadContentAsBinHex(Byte[], Int32, Int32)가 현재 노드에서 지원되지 않습니다.ReadContentAsBinHex(Byte[], Int32, Int32) is not supported on the current node.

-또는--or-

이전 비동기 작업이 완료되기 전에 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."

버퍼 또는 인덱스 + 카운트에 대 한 인덱스 할당된 된 버퍼 크기 보다 큽니다.The index into the buffer or index + count is larger than the allocated buffer size.

구현된 XmlReader에서 이 메서드를 지원하지 않는 경우The XmlReader implementation does not support this method.

Remarks

이 메서드는 콘텐츠를 스트리밍하 고 BinHex 콘텐츠를 디코딩하고 디코딩된 이진 바이트 (예: 인라인 BinHex 인코딩된 GIF 이미지)를 버퍼로 반환 합니다.This method streams the content, decodes the BinHex content, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer. 포함 된 텍스트의 큰 스트림을 읽도록 연속적으로이 메서드를 호출할 수 있습니다.This method can be called successively to read large streams of embedded text.

Note

메서드가 0값을 반환할 때까지 ReadContentAsBinHex 메서드 호출 사이의 판독기 속성에 액세스 하면 안 됩니다.You should not access any of the reader properties between calls to the ReadContentAsBinHex method until the method returns the value 0.

이 메서드에 다음과 같은 동작이 있습니다.This method has the following behavior:

  • ReadContentAsBinHex은 작업 중인 바이트 스트림의 끝에 도달한 경우 0 값을 반환 합니다.ReadContentAsBinHex returns the value 0 when it has reached the end of the byte stream it was operating on. 판독기는 첫 번째 비 콘텐츠 노드에 배치 됩니다.The reader is positioned on the first non-content node.

  • 더 적은 묻는 경우 남아 있는 것 보다는 스트림 판독기 바이트의 정확한 수를 현재 위치에 유지 됩니다.If you ask for fewer, or the exact number, of bytes than are left in the stream the reader remains in its current position.

  • ReadContentAsBinHexElement, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragmentXML 노드 유형에 서 지원 되지 않습니다.ReadContentAsBinHex is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

이 메서드의 비동기 버전은 ReadContentAsBinHexAsync를 참조 하세요.For the asynchronous version of this method, see ReadContentAsBinHexAsync.

Applies to

See also