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

Definition

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

public:
 virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBase64 (byte[] buffer, int index, int count);
abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overridable Function ReadContentAsBase64 (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.

ReadContentAsBase64(Byte[], Int32, Int32)가 현재 노드에서 지원되지 않습니다.ReadContentAsBase64(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

이 메서드는 콘텐츠를 스트리밍하 고 Base64 콘텐츠를 디코딩하고 디코딩된 이진 바이트 (예: 인라인 Base64 인코딩된 GIF 이미지)를 버퍼로 반환 합니다.This method streams the content, decodes the Base64 content, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. 포함 된 텍스트의 큰 스트림을 읽도록 연속적으로이 메서드를 호출할 수 있습니다.This method can be called successively to read large streams of embedded text. 자세한 내용은 RFC 1521을 참조 하세요. "MIME (Multipurpose Internet Mail Extensions) 파트 1:를 지정 하 고 인터넷 메시지 본문의 형식을 설명 하는 메커니즘".For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". 의견 요청 웹 사이트에서 rfc를 받을 수 있습니다.You can obtain RFCs from the Request for Comments Web site.

Note

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

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

  • ReadContentAsBase64은 작업 중인 바이트 스트림의 끝에 도달한 경우 0 값을 반환 합니다.ReadContentAsBase64 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.

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

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

Applies to

See also