XmlWriter.WriteStartElement

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

XmlWriter.WriteStartElement メソッド (String, String)

派生クラスでオーバーライドされると、指定した開始タグを書き込み、指定した名前空間に関連付けます。

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

Visual Basic (宣言)

Public Sub WriteStartElement ( _
    localName As String, _
    ns As String _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim localName As String
Dim ns As String

instance.WriteStartElement(localName, ns)

C#

public void WriteStartElement (
    string localName,
    string ns
)

C++

public:
void WriteStartElement (
    String^ localName, 
    String^ ns
)

J#

public void WriteStartElement (
    String localName, 
    String ns
)

JScript

public function WriteStartElement (
    localName : String, 
    ns : String
)

パラメータ

localName

要素のローカル名。

ns

要素に関連付ける名前空間 URI。この名前空間が既にスコープ内にあり、関連付けられたプリフィックスを持つ場合、ライタは、そのプリフィックスも自動的に書き込みます。

例外

例外の種類	条件
InvalidOperationException	ライタが閉じています。

解説

このメソッドを呼び出した後、属性を書き込むか、子要素の WriteComment、WriteString、または WriteStartElement を使用して内容を作成できます。WriteEndElement または WriteFullEndElement で要素を閉じることができます。C# コード例を次に示します。

 writer.WriteStartElement("item",null);
 writer.WriteString("some text");
 writer.WriteEndElement();

次の出力を生成します。

 <item>some text</item>

プラットフォーム

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

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方

XmlWriter.WriteStartElement メソッド (String, String, String)

派生クラスでオーバーライドされると、指定した開始タグを書き込み、指定した名前空間とプリフィックスに関連付けます。

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

Visual Basic (宣言)

Public MustOverride Sub
 WriteStartElement ( _
    prefix As String, _
    localName As String, _
    ns As String _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim prefix As String
Dim localName As String
Dim ns As String

instance.WriteStartElement(prefix, localName, ns)

C#

public abstract void WriteStartElement (
    string prefix,
    string localName,
    string ns
)

C++

public:
virtual void WriteStartElement (
    String^ prefix, 
    String^ localName, 
    String^ ns
) abstract

J#

public abstract void WriteStartElement (
    String prefix, 
    String localName, 
    String ns
)

JScript

public abstract function WriteStartElement
 (
    prefix : String, 
    localName : String, 
    ns : String
)

パラメータ

prefix

要素の名前空間プリフィックス。

localName

要素のローカル名。

ns

要素に関連付ける名前空間 URI。

例外

例外の種類	条件
InvalidOperationException	ライタが閉じています。

使用例

XML フラグメントを書き込む例を次に示します。

Visual Basic

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared m_Document As
 String = "sampledata.xml"
    
    Public Shared Sub Main()
        Dim writer As XmlWriter = Nothing
        
      Try

        Dim settings As XmlWriterSettings =
 new XmlWriterSettings()
        settings.Indent = true
        writer = XmlWriter.Create (m_Document)
            
        writer.WriteComment("sample XML fragment")
            
        ' Write an element (this one is the root).
        writer.WriteStartElement("book")
            
        ' Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk",
 Nothing, "urn:samples")
            
        ' Write the genre attribute.
        writer.WriteAttributeString("genre", "novel")
            
        ' Write the title.
        writer.WriteStartElement("title")
        writer.WriteString("The Handmaid's Tale")
        writer.WriteEndElement()
            
        ' Write the price.
        writer.WriteElementString("price", "19.95")
            
        ' Lookup the prefix and write the ISBN element.
        Dim prefix As String
 = writer.LookupPrefix("urn:samples")
        writer.WriteStartElement(prefix, "ISBN", "urn:samples")
        writer.WriteString("1-861003-78")
        writer.WriteEndElement()
            
        ' Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples",
 "hardcover")
            
        ' Write the close tag for the root element.
        writer.WriteEndElement()
            
        ' Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        Finally
            If Not (writer Is
 Nothing) Then
                writer.Close()
            End If
        End Try

    End Sub 'Main 
End Class 'Sample

C#

using System;
using System.IO;
using System.Xml;
 
 public class Sample
 {
   private const string
 m_Document = "sampledata.xml";
 
   public static void Main()
 {
   
      XmlWriter writer = null;

      try {
     
        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document);
           
        writer.WriteComment("sample XML fragment");
     
        // Write an element (this one is the root).
        writer.WriteStartElement("book");
 
        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null,
 "urn:samples");
    
        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");
         
        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();
               
        // Write the price.
        writer.WriteElementString("price", "19.95");
      
        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle
 prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");
 
        // Write the close tag for the root element.
        writer.WriteEndElement();
               
        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();
      }

      finally {
        if (writer != null)
           writer.Close();
     } 
   }
 
 }

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr,
 L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel"
 );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples"
 );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle
 prefixes).
         writer->WriteElementString( L"style", L"urn:samples",
 L"hardcover" );
         
         // Write the close tag for the root element.
         writer->WriteEndElement();
         
         // Write the XML to file and close the writer.
         writer->Flush();
         writer->Close();
      }
      finally
      {
         if ( writer != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}

プラットフォーム

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

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方

XmlWriter.WriteStartElement メソッド

派生クラスでオーバーライドされると、指定した開始タグを書き込みます。
オーバーロードの一覧

名前	説明
XmlWriter.WriteStartElement (String)	派生クラスでオーバーライドされると、指定したローカル名の開始タグを書き込みます。 .NET Compact Framework によってサポートされています。
XmlWriter.WriteStartElement (String, String)	派生クラスでオーバーライドされると、指定した開始タグを書き込み、指定した名前空間に関連付けます。 .NET Compact Framework によってサポートされています。
XmlWriter.WriteStartElement (String, String, String)	派生クラスでオーバーライドされると、指定した開始タグを書き込み、指定した名前空間とプリフィックスに関連付けます。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間

その他の技術情報

XmlWriter による XML の書き方
XmlWriter による XML の書き方

XmlWriter による XML の書き方