XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要素を読み取り、Base64 コンテンツをデコードします。
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64(byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integerパラメーター
- buffer
- Byte[]
結果のテキストをコピーするバッファー。 この値を null にすることはできません。
- index
- Int32
結果のコピーを開始するバッファーへのオフセット。
- count
- Int32
バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。
返品
バッファーに書き込まれたバイト数。
例外
buffer 値は nullです。
現在のノードは要素ノードではありません。
バッファーまたはインデックス + カウントへのインデックスが、割り当てられたバッファー サイズよりも大きい。
XmlTextReader実装では、このメソッドはサポートされていません。
要素には混合コンテンツが含まれています。
コンテンツを要求された型に変換することはできません。
例
このメソッドを使用した例については、 XmlReader.ReadElementContentAsBase64 を参照してください。
注釈
Note
新しい機能を利用するには、XmlReader メソッドを使用してXmlReader.Create インスタンスを作成することをお勧めします。
このメソッドは、要素の内容を読み取り、Base64 エンコードを使用してデコードし、デコードされたバイナリ バイト (たとえば、インラインの Base64 エンコード GIF イメージ) をバッファーに返します。 詳細については、RFC 1521「MIME (多目的インターネット メール拡張機能) パート 1: インターネット メッセージ本文の形式を指定および記述するためのメカニズム」を参照してください。 RFC は、 コメント要求 Web サイトから取得できます。
このメソッドは、単純なコンテンツ要素のみを読み取ることができます。 要素には、テキスト、空白、重要な空白、CDATA セクション、コメント、および処理命令を含めることができます。 また、自動的に展開されるエンティティ参照を含めることもできます。 要素に子要素を含めることはできません。
このメソッドは、要素ノード型でのみ呼び出すことができる点を除いて、 ReadContentAsBase64 メソッドとよく似ています。
count値がドキュメント内のバイト数より大きい場合、またはドキュメント内のバイト数と等しい場合、XmlTextReaderはドキュメント内の残りのすべてのバイトを読み取り、読み取ったバイト数を返します。 次の XmlTextReader メソッド呼び出しは 0 を返し、リーダーを EndElementの後のノードに移動します。
すべての要素コンテンツが使用される前に Read を呼び出すと、リーダーは最初のコンテンツが使用されたかのように動作し、次に Read メソッドが呼び出された可能性があります。 つまり、リーダーは、終了要素が検出されるまですべてのテキストを読み取ります。 次に、終了タグ ノードを読み取り、次のノードを読み取り、それ自体を次の後続のノードに配置します。
