XmlTextReader.WhitespaceHandling プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlTextReader.WhitespaceHandling プロパティ

空白の処理方法を指定する値を取得または設定します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property WhitespaceHandling As
 WhitespaceHandling

Visual Basic (使用法)

Dim instance As XmlTextReader
Dim value As WhitespaceHandling

value = instance.WhitespaceHandling

instance.WhitespaceHandling = value

public WhitespaceHandling WhitespaceHandling { get;
 set; }

C++

public:
property WhitespaceHandling WhitespaceHandling {
    WhitespaceHandling get ();
    void set (WhitespaceHandling value);
}

/** @property */
public WhitespaceHandling get_WhitespaceHandling ()

/** @property */
public void set_WhitespaceHandling (WhitespaceHandling
 value)

JScript

public function get WhitespaceHandling
 () : WhitespaceHandling

public function set WhitespaceHandling
 (value : WhitespaceHandling)

プロパティ値
WhitespaceHandling 値の 1 つ。既定値は WhitespaceHandling.All で、Whitespace ノードと SignificantWhitespace ノードを返します。

例外

例外の種類	条件
ArgumentOutOfRangeException	無効な値を指定しています。
InvalidOperationException	リーダーが閉じているとき (ReadState が ReadState.Closed のとき) にこのプロパティを設定します。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlReader.Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、このリリースで導入された新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

このプロパティはいつでも変更でき、次の読み取り操作時に有効となります。

XmlTextReader は使用できる DTD 情報を持っていないため、SignificantWhitepsace ノードは xml:space='preserve' スコープ内だけで返されます。

使用例

XML フラグメントを読み取る例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main()

    'Create the XML fragment to be parsed.
    Dim xmlFrag as string
 ="<book> " & _
                           "  <title>Pride And Prejudice</title>"
 & _
                           "  <genre>novel</genre>"
 & _
                           "</book>" 

    'Create the XmlNamespaceManager.
    Dim nt as NameTable = new
 NameTable()
    Dim nsmgr as XmlNamespaceManager = new
 XmlNamespaceManager(nt)

    'Create the XmlParserContext.
    Dim context as XmlParserContext = new
 XmlParserContext(nothing, nsmgr, nothing,
 XmlSpace.Default)

    Console.WriteLine("Read the XML and ignore all white space...")
    ReadXML(context, xmlFrag, WhitespaceHandling.None)

    Console.WriteLine()
    Console.WriteLine("Read the XML including white space nodes...")
    ReadXML(context, xmlFrag, WhitespaceHandling.All)
  end sub
  
  public shared sub ReadXML(context
 as XmlParserContext, xmlFrag as string,
 ws as WhitespaceHandling)

    'Create the reader and specify the WhitespaceHandling setting.
    Dim reader as XmlTextReader = new
 XmlTextReader(xmlFrag, XmlNodeType.Element, context)
    reader.WhitespaceHandling = ws

      'Parse the XML and display each of the nodes.
      while (reader.Read())
         select case reader.NodeType
           case XmlNodeType.Element:
             Console.WriteLine("{0}: <{1}>",
 reader.NodeType, reader.Name)
           case XmlNodeType.Text:
             Console.WriteLine("{0}: {1}", reader.NodeType,
 reader.Value)
           case XmlNodeType.EndElement:
             Console.WriteLine("{0}: </{1}>",
 reader.NodeType, reader.Name)
           case XmlNodeType.Whitespace:
             Console.WriteLine("{0}:", reader.NodeType)
           case XmlNodeType.SignificantWhitespace:
             Console.WriteLine("{0}:", reader.NodeType)
         end select       
      end while           
  
    'Close the reader.
    reader.Close()     
  
  end sub
end class

using System;
using System.IO;
using System.Xml;

public class Sample 
{
  public static void Main(){

    //Create the XML fragment to be parsed.
    string xmlFrag ="<book> " +
                    "  <title>Pride And Prejudice</title>"
 +
                    "  <genre>novel</genre>" +
                    "</book>"; 

    //Create the XmlNamespaceManager.
    NameTable nt = new NameTable();
    XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);

    //Create the XmlParserContext.
    XmlParserContext context = new XmlParserContext(null,
 nsmgr, null, XmlSpace.Default);

    Console.WriteLine("Read the XML and ignore all white space...");
    ReadXML(context, xmlFrag, WhitespaceHandling.None);

    Console.WriteLine("\r\nRead the XML including white space nodes...");
    ReadXML(context, xmlFrag, WhitespaceHandling.All);

  }
  
  public static void ReadXML(XmlParserContext
 context, string xmlFrag, WhitespaceHandling ws){

    //Create the reader and specify the WhitespaceHandling setting.
    XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element,
 context);
    reader.WhitespaceHandling = ws;

      //Parse the XML and display each of the nodes.
      while (reader.Read())
      {
         switch (reader.NodeType)
         {
           case XmlNodeType.Element:
             Console.WriteLine("{0}: <{1}>", reader.NodeType, reader.Name);
             break;
           case XmlNodeType.Text:
             Console.WriteLine("{0}: {1}", reader.NodeType, reader.Value);
             break;
           case XmlNodeType.EndElement:
             Console.WriteLine("{0}: </{1}>", reader.NodeType, reader.Name);
             break;
           case XmlNodeType.Whitespace:
             Console.WriteLine("{0}:", reader.NodeType);
             break;
           case XmlNodeType.SignificantWhitespace:
             Console.WriteLine("{0}:", reader.NodeType);
             break;
         }       
      }           
  
    //Close the reader.
    reader.Close();     
  
  }
} // End class

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void ReadXML( XmlParserContext^ context, String^ xmlFrag, WhitespaceHandling
 ws )
{
   
   //Create the reader and specify the WhitespaceHandling setting.
   XmlTextReader^ reader = gcnew XmlTextReader( xmlFrag,XmlNodeType::Element,context
 );
   reader->WhitespaceHandling = ws;
   
   //Parse the XML and display each of the nodes.
   while ( reader->Read() )
   {
      switch ( reader->NodeType )
      {
         case XmlNodeType::Element:
            Console::WriteLine( "{0}: <{1}>", reader->NodeType,
 reader->Name );
            break;

         case XmlNodeType::Text:
            Console::WriteLine( "{0}: {1}", reader->NodeType, reader->Value
 );
            break;

         case XmlNodeType::EndElement:
            Console::WriteLine( "{0}: </{1}>", reader->NodeType,
 reader->Name );
            break;

         case XmlNodeType::Whitespace:
            Console::WriteLine( "{0}:", reader->NodeType );
            break;

         case XmlNodeType::SignificantWhitespace:
            Console::WriteLine( "{0}:", reader->NodeType );
            break;
      }
   }

   
   //Close the reader.
   reader->Close();
}

int main()
{
   
   //Create the XML fragment to be parsed.
   String^ xmlFrag = "<book> "
   "  <title>Pride And Prejudice</title>"
   "  <genre>novel</genre>"
   "</book>";
   
   //Create the XmlNamespaceManager.
   NameTable^ nt = gcnew NameTable;
   XmlNamespaceManager^ nsmgr = gcnew XmlNamespaceManager( nt );
   
   //Create the XmlParserContext.
   XmlParserContext^ context = gcnew XmlParserContext( nullptr,nsmgr,nullptr,XmlSpace::Default
 );
   Console::WriteLine( "Read the XML and ignore all white space..." );
   ReadXML( context, xmlFrag, WhitespaceHandling::None );
   Console::WriteLine( "\r\nRead the XML including white space nodes..."
 );
   ReadXML( context, xmlFrag, WhitespaceHandling::All );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        //Create the XML fragment to be parsed.
        String xmlFrag = "<book> " + "  <title>Pride And
 Prejudice</title>" 
            + "  <genre>novel</genre>" + "</book>";

        //Create the XmlNamespaceManager.
        NameTable nt =  new NameTable();
        XmlNamespaceManager nsMgr =  new XmlNamespaceManager(nt);

        //Create the XmlParserContext.
        XmlParserContext context =  new XmlParserContext
            (null, nsMgr, null, XmlSpace.Default);
        Console.WriteLine("Read the XML and ignore all white space...");
        ReadXML(context, xmlFrag, WhitespaceHandling.None);
        Console.WriteLine("\r\nRead the XML including white space nodes...");
        ReadXML(context, xmlFrag, WhitespaceHandling.All);
    } //main

    public static void ReadXML(XmlParserContext
 context, String xmlFrag,
        WhitespaceHandling ws)
    {
        //Create the reader and specify the WhitespaceHandling setting.
        XmlTextReader reader = 
            new XmlTextReader(xmlFrag, XmlNodeType.Element, context);
        reader.set_WhitespaceHandling(ws);

        //Parse the XML and display each of the nodes.
        while(reader.Read()) {
            switch(reader.get_NodeType()) {
                case XmlNodeType.Element : 
                    Console.WriteLine("{0}: <{1}>", 
                        reader.get_NodeType(), reader.get_Name());
                    break;
                case XmlNodeType.Text : 
                    Console.WriteLine("{0}: {1}", 
                        reader.get_NodeType(), reader.get_Value());
                    break;
                case XmlNodeType.EndElement : 
                    Console.WriteLine("{0}: </{1}>", 
                        reader.get_NodeType(), reader.get_Name());
                    break;
                case XmlNodeType.Whitespace : 
                    Console.WriteLine("{0}:", reader.get_NodeType());
                    break;
                case XmlNodeType.SignificantWhitespace : 
                    Console.WriteLine("{0}:", reader.get_NodeType());
                    break;
            }
        }
        //Close the reader.
        reader.Close();
    } //ReadXML 
} // End class Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlTextReader クラス
XmlTextReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り

このページでは「.NET Framework クラスライブラリリファレンス」からXmlTextReader.WhitespaceHandling プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からXmlTextReader.WhitespaceHandling プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からXmlTextReader.WhitespaceHandling プロパティを検索

>> 「XmlTextReader.WhitespaceHandling プロパティ」を含む用語の索引
XmlTextReader.WhitespaceHandling プロパティのページへのリンク


	© 2025 Microsoft.All rights reserved.

XmlTextReader.WhitespaceHandling プロパティとは？ わかりやすく解説

XmlTextReader.WhitespaceHandling プロパティ

急上昇のことば

XmlTextReader.WhitespaceHandling プロパティとは？わかりやすく解説