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

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

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

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

XmlTextReader.Normalization プロパティ

空白と属性値を正規化するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Normalization As
 Boolean

Visual Basic (使用法)

Dim instance As XmlTextReader
Dim value As Boolean

value = instance.Normalization

instance.Normalization = value

public bool Normalization { get;
 set; }

C++

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

/** @property */
public boolean get_Normalization ()

/** @property */
public void set_Normalization (boolean value)

JScript

public function get Normalization
 () : boolean

public function set Normalization
 (value : boolean)

プロパティ値
正規化する場合は true。それ以外の場合は false。既定値は false です。

例外

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

解説

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

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

メモ
XmlTextReader を使用して XmlValidatingReader を構築し、属性値を正規化する場合は、Normalization を true に設定する必要があります。

Normalization を false に設定すると、数値エンティティをチェックする文字範囲も無効になります。その結果、 などの文字エンティティが許可されます。

属性値の正規化について次に説明します。

文字参照の場合は、参照する文字を属性値に付け加えます。
エンティティ参照の場合は、エンティティの置換テキストを再帰的に処理します。
空白文字 (#x20、#xD、#xA、#x9) の場合は、正規化した値に #x20 を付け加えます外部解析エンティティの一部または内部解析エンティティのリテラルエンティティ値である "#xD#xA" シーケンスに対しては、単一の #x20 だけが付け加えられます。
これらの空白文字を正規化した値に付け加えて、他の文字を処理します。
宣言された値が CDATA でない場合は、前後の空白 (#x20) 文字をすべて破棄し、連続した空白 (#x20) 文字を単一の空白 (#x20) 文字に置き換えます。

XmlTextReader は、属性の正規化または CDATA の正規化だけを実行します。XmlValidatingReader 内にラップされない限り、DTD 固有の正規化は実行しません。

正規化の詳細については、W3C 勧告『XML 1.0』を参照してください。

使用例

正規化をオンにし、次にオフにしたときのリーダーの動作を次の例に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Xml
Imports Microsoft.VisualBasic

public class Sample

  public shared sub Main()

    ' Create the XML fragment to be parsed.
    Dim xmlFrag as string
 = "<item attr1='  test A B C " + Chr(10) & _
                            "   1 2 3'/>" + Chr(10) &
 _
                            "<item attr2='&#01;'/>"
                    

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

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

    ' Create the reader.
    Dim reader as XmlTextReader = new
 XmlTextReader(xmlFrag, XmlNodeType.Element, context)

    ' Show attribute value normalization.
    reader.Read()
    reader.Normalization = false
    Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr1"))
    reader.Normalization = true
    Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr1"))

    ' Set Normalization back to false.  This allows the reader to accept
    ' character entities in the &#00; to &#20; range.  If Normalization
 had
    ' been set to true, character entities in this range throw an exception.
    reader.Normalization = false
    reader.Read()
    reader.MoveToContent()
    Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr2"))
  
    ' 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  = 
    @"<item attr1='  test A B C
        1 2 3'/>
      <item attr2='&#01;'/>";                         

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

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

    // Create the reader.
    XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element,
 context);

    // Show attribute value normalization.
    reader.Read();
    reader.Normalization = false;
    Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr1"));
    reader.Normalization = true;
    Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr1"));

    // Set Normalization back to false.  This allows the reader to accept
    // character entities in the &#00; to &#20; range.  If Normalization
 had
    // been set to true, character entities in this range throw an exception.
    reader.Normalization = false;
    reader.Read();
    reader.MoveToContent();
    Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr2"));
  
    // Close the reader.
    reader.Close();     
  
  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create the XML fragment to be parsed.
   String^ xmlFrag = "<item attr1='  test A B C\n"
   "1 2 3'/>\n"
   "<item attr2='&#01;'/>\n";
   
   // Create the XmlNamespaceManager.
   XmlNamespaceManager^ nsmgr = gcnew XmlNamespaceManager( gcnew NameTable );
   
   // Create the XmlParserContext.
   XmlParserContext^ context = gcnew XmlParserContext( nullptr,nsmgr,nullptr,XmlSpace::Preserve
 );
   
   // Create the reader.
   XmlTextReader^ reader = gcnew XmlTextReader( xmlFrag,XmlNodeType::Element,context
 );
   
   // Show attribute value normalization.
   reader->Read();
   reader->Normalization = false;
   Console::WriteLine( "Attribute value: {0}", reader->GetAttribute(
 "attr1" ) );
   reader->Normalization = true;
   Console::WriteLine( "Attribute value: {0}", reader->GetAttribute(
 "attr1" ) );
   
   // Set Normalization back to false.  This allows the reader to accept
   // character entities in the &#00; to &#20; range.  If Normalization
 had
   // been set to true, character entities in this range throw an exception.
   reader->Normalization = false;
   reader->Read();
   reader->MoveToContent();
   Console::WriteLine( "Attribute value: {0}", reader->GetAttribute(
 "attr2" ) );
   
   // Close the reader.
   reader->Close();
}

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 = "<item attr1='  test A B C\n" + "    
    1 2 3'/>\n" 
            + "      <item attr2='&#01;'/>";
        // Create the XmlNamespaceManager.
        XmlNamespaceManager nsMgr = new XmlNamespaceManager(new
 NameTable());
        // Create the XmlParserContext.
        XmlParserContext context = new XmlParserContext(null,
 nsMgr,
            null, XmlSpace.Preserve);
        // Create the reader.
        XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element
,
            context);
        // Show attribute value normalization.
        reader.Read();
        reader.set_Normalization(false);
        Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr1"));
        reader.set_Normalization(true);
        Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr1"));
        // Set Normalization back to false.  This allows the reader
 to accept
        // character entities in the &#00; to &#20; range.  If Normalization
 had
        // been set to true, character entities in this range throw
 an exception.
        reader.set_Normalization(false);
        reader.Read();
        reader.MoveToContent();
        Console.WriteLine("Attribute value:{0}", reader.GetAttribute("attr2"));
        // Close the reader.
        reader.Close();
    } //main 
} //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.Normalization プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からXmlTextReader.Normalization プロパティを検索する場合は、下記のリンクをクリックしてください。

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

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


	© 2025 Microsoft.All rights reserved.

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

XmlTextReader.Normalization プロパティ

急上昇のことば

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