XmlWriterSettings.NewLineOnAttributes プロパティ

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

XmlWriterSettings.NewLineOnAttributes プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

新しい行に属性を書き込むかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property NewLineOnAttributes As
 Boolean

Visual Basic (使用法)

Dim instance As XmlWriterSettings
Dim value As Boolean

value = instance.NewLineOnAttributes

instance.NewLineOnAttributes = value

C#

public bool NewLineOnAttributes { get;
 set; }

C++

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

J#

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

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

JScript

public function get NewLineOnAttributes
 () : boolean

public function set NewLineOnAttributes
 (value : boolean)

プロパティ値
個々の行に属性を書き込む場合は true。それ以外の場合は false。既定値は false です。

メモ
Indent プロパティ値が false の場合、この設定は無効です。

NewLineOnAttributes を true に設定すると、各属性は、新しい行にインデントを 1 レベル増やして記述されます。

解説

このプロパティは、テキストの内容を出力する、XmlWriter のインスタンスにのみ適用されます。それ以外の場合、この設定は無視されます。

使用例

XML ファイルに書き込みを行う XmlWriter を作成し、新しい行にそれぞれの属性を書き込む方法の例を次に示します。

Visual Basic

Dim settings As XmlWriterSettings = New
 XmlWriterSettings()
settings.Indent = true
settings.OmitXmlDeclaration = true
settings.NewLineOnAttributes = true
       
writer = XmlWriter.Create(Console.Out, settings)

writer.WriteStartElement("order")
writer.WriteAttributeString("orderID", "367A54")
writer.WriteAttributeString("date", "2001-05-03")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
    
writer.Flush()

C#

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
settings.NewLineOnAttributes = true;
       
writer = XmlWriter.Create(Console.Out, settings);

writer.WriteStartElement("order");
writer.WriteAttributeString("orderID", "367A54");
writer.WriteAttributeString("date", "2001-05-03");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
    
writer.Flush();

このサンプルの出力は、次のようになります。

<order
  orderID="367A54"
  date="2001-05-03">
  <price>19.95</price>
</order>

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterSettings クラス
XmlWriterSettings メンバ
System.Xml 名前空間
その他の技術情報
XML ライタの作成