XmlValidatingReader.ReadContentAsBase64(Byte[], Int32, Int32) メソッド

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlValidatingReader.cs

コンテンツを読み取り、Base64 デコードされたバイナリ バイトを返します。

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadContentAsBase64(byte[] buffer, int index, int count);

override this.ReadContentAsBase64 : byte[] * int * int -> int

Public Overrides Function ReadContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integer

パラメーター

buffer

Byte[]

結果のテキストをコピーするバッファー。 この値を null にすることはできません。

index

Int32

結果のコピーを開始するバッファーへのオフセット。

count

Int32

バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。

返品

Int32

バッファーに書き込まれたバイト数。

例外

ArgumentNullException

buffer 値は nullです。

InvalidOperationException

ReadContentAsBase64(Byte[], Int32, Int32) は、現在のノードではサポートされていません。

ArgumentOutOfRangeException

バッファーまたはインデックス + カウントへのインデックスが、割り当てられたバッファー サイズよりも大きい。

注釈

Note

XmlValidatingReader クラスは、.NET Framework 2.0 では使用されなくなりました。 XmlReader クラスと XmlReaderSettings メソッドを使用して、検証Createインスタンスを作成できます。 詳細については、XmlReader のリファレンス ページの「解説」を参照してください。

このメソッドは、コンテンツをストリーミングし、Base64 コンテンツをデコードし、デコードされたバイナリ バイト (たとえば、インラインの Base64 エンコード GIF イメージ) をバッファーに返します。 このメソッドは、埋め込みテキストの大きなストリームを読み取るために連続して呼び出すことができます。 詳細については、RFC 1521「MIME (多目的インターネット メール拡張機能) パート 1: インターネット メッセージ本文の形式を指定および記述するためのメカニズム」を参照してください。 RFC は、 コメント要求 Web サイトから取得できます。

Note

メソッドが値 0 を返すまで、 ReadContentAsBase64 メソッドの呼び出しの間にリーダー プロパティにアクセスしないでください。

このメソッドの動作は次のとおりです。

• ReadContentAsBase64 は、操作対象のバイト ストリームの末尾に達したときに値 0 を返します。 リーダーは、最初の非コンテンツ ノードに配置されます。

• ストリームに残っているバイト数よりも少ないバイト数または正確な数を要求した場合、リーダーは現在の位置に残ります。

• ReadContentAsBase64 は、要素、XmlDeclaration、None、Document、DocumentType、Notation、Entity、DocumentFragment の各 XML ノードタイプではサポートされていません。

こちらもご覧ください

• XmlReader
• ReadElementContentAsBase64(Byte[], Int32, Int32)
• XmlNodeType