XmlNodeReader.ReadElementContentAsBase64(Byte[], Int32, Int32) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

要素を読み取り、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 -> int

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

パラメーター

buffer

Byte[]

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

index

Int32

バッファー内の結果のコピー開始位置を示すオフセット。

count

Int32

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

戻り値

Int32

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

例外

ArgumentNullException

buffer 値は null です。

InvalidOperationException

現在のノードは要素ノードではありません。

ArgumentOutOfRangeException

バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。

XmlException

要素には混合コンテンツが含まれます。

FormatException

コンテンツを要求された型に変換できません。

例

XmlReader.ReadElementContentAsBase64このメソッドを使用した例については、以下を参照してください。

注釈

注意

.NET Framework 2.0 では、 クラスと Create メソッドを使用してインスタンスをXmlReaderSettings作成XmlReaderすることをお勧めします。 これにより、.NET Frameworkで導入されたすべての新機能を最大限に活用できます。 詳細については、リファレンス ページの「解説」セクションを XmlReader 参照してください。

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

このメソッドは、単純なコンテンツ要素のみを読み取ることができます。 要素には、テキスト、空白、重要な空白、CDATA セクション、コメント、および処理命令を含めることができます。 また、自動的に展開されるエンティティ参照を含めることもできます。 要素に子要素を含めることはできません。

このメソッドは、要素ノード型でのみ呼び出すことができる点を除いて、 メソッドとよく似ています ReadContentAsBase64 。

count 値がドキュメント内のバイト数より大きい場合、またはドキュメント内のバイト数と等しい場合は、ドキュメント内の残りのすべてのバイトが読み取られ、 XmlNodeReader 読み取られたバイト数が返されます。 次 ReadElementContentAsBase64 のメソッド呼び出しは 0 を返し、リーダーをノードの後のノードに EndElement 移動します。

すべての要素コンテンツが使用される前に を呼び出 Read すと、リーダーは最初のコンテンツが使用されたかのように動作し、次に メソッドが Read 呼び出された可能性があります。 つまり、リーダーは end 要素が検出されるまですべてのテキストを読み取ります。 次に、終了タグ ノードを読み取り、次のノードを読み取り、それ自体を次の後続のノードに配置します。

こちらもご覧ください

• ReadContentAsBase64(Byte[], Int32, Int32)
• ReadElementContentAsBinHex(Byte[], Int32, Int32)