XmlWriter.Create メソッド

public:
 static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);

static member Create : System.Text.StringBuilder * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As StringBuilder, settings As XmlWriterSettings) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

public:
 static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings? settings);

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings settings);

static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

例

次の例では、定義された設定を XmlWriter 使用して オブジェクトを作成します。

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

public class Sample {

  public static void Main() {

    XmlWriter writer = null;

    try {

       // Create an XmlWriterSettings object with the correct options.
       XmlWriterSettings settings = new XmlWriterSettings();
       settings.Indent = true;
       settings.IndentChars = ("\t");
       settings.OmitXmlDeclaration = true;

       // Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings);
       writer.WriteStartElement("book");
       writer.WriteElementString("item", "tesing");
       writer.WriteEndElement();
    
       writer.Flush();
     }
     finally  {
        if (writer != null)
          writer.Close();
     }
  }
}

Imports System.IO
Imports System.Xml
Imports System.Text

Public Class Sample 

  Public Shared Sub Main() 
  
    Dim writer As XmlWriter = Nothing

    Try 

       ' Create an XmlWriterSettings object with the correct options. 
       Dim settings As XmlWriterSettings = New XmlWriterSettings()
       settings.Indent = true
       settings.IndentChars = (ControlChars.Tab)
       settings.OmitXmlDeclaration = true

       ' Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings)
       writer.WriteStartElement("book")
       writer.WriteElementString("item", "tesing")
       writer.WriteEndElement()
    
       writer.Flush()

      Finally
         If Not (writer Is Nothing) Then
            writer.Close()
         End If
      End Try

   End Sub 
End Class

public:
 static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);

static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

例

次の例では、XML 文字列を書き込みます。

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
StringWriter sw = new StringWriter();

using (XmlWriter writer = XmlWriter.Create(sw, settings))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();

    String output = sw.ToString();
}

Dim settings As New XmlWriterSettings()
settings.OmitXmlDeclaration = True
Dim sw As New StringWriter()
        
Using writer As XmlWriter = XmlWriter.Create(sw, settings)
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
            
  Dim output As String = sw.ToString()
End Using

public:
 static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

例

次の例では、XML フラグメントをメモリ ストリームに書き込みます。

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

注釈

XmlWriter は常に、基になるデータ ストリームにバイトオーダー マーク (BOM) を書き込みます。ただし、一部のストリームには BOM を含めてはなりません。 BOM を省略するには、新 XmlWriterSettings しいオブジェクトを作成し、Encoding プロパティを新 UTF8Encoding しいオブジェクトに設定し、コンストラクターのブール値を false に設定します。

public:
 static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);

static member Create : System.Xml.XmlWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As XmlWriter, settings As XmlWriterSettings) As XmlWriter

パラメーター

戻り値

指定された XmlWriter オブジェクトをラップする XmlWriter オブジェクト。

例外

注釈

このメソッドを使用すると、基になる XmlWriter オブジェクトに追加の機能を追加できます。 基になる XmlWriter オブジェクトには、 メソッドによって XmlWriter.Create 作成されたオブジェクト、または 実装を使用して作成されたオブジェクトを XmlTextWriter 指定できます。

public:
 static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output);

static member Create : System.Text.StringBuilder -> System.Xml.XmlWriter

Public Shared Function Create (output As StringBuilder) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

注釈

このオーバーロードを使用すると、XML ライターを XmlWriterSettings 作成するために、既定の設定を持つ オブジェクトが使用されます。

作成した XML ライターでサポートする機能を指定する場合は、オブジェクトを引数の 1 つとして受け取り XmlWriterSettings 、カスタム設定で オブジェクトを XmlWriterSettings 渡すオーバーロードを使用します。

public:
 static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName);

public static System.Xml.XmlWriter Create (string outputFileName);

static member Create : string -> System.Xml.XmlWriter

Public Shared Function Create (outputFileName As String) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

例

次の例では、 オブジェクトを XmlWriter 作成し、書籍ノードを書き込みます。

using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Using writer As XmlWriter = XmlWriter.Create("output.xml")
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

注釈

このオーバーロードを使用すると、XML ライターを XmlWriterSettings 作成するために、既定の設定を持つ オブジェクトが使用されます。

作成した XML ライターでサポートする機能を指定する場合は、オブジェクトを引数の 1 つとして受け取り XmlWriterSettings 、カスタム設定で オブジェクトを XmlWriterSettings 渡すオーバーロードを使用します。

public:
 static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output);

static member Create : System.IO.TextWriter -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

例

次の例では、コンソールに出力するライターを作成します。

using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Using writer As XmlWriter = XmlWriter.Create(Console.Out)
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

注釈

このオーバーロードを使用すると、XML ライターを XmlWriterSettings 作成するために、既定の設定を持つ オブジェクトが使用されます。

作成されたライターでサポートする機能を指定する場合は、オブジェクトを引数の 1 つとして受け取り XmlWriterSettings 、カスタム設定で オブジェクトを XmlWriterSettings 渡すオーバーロードを使用します。

public:
 static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output);

public static System.Xml.XmlWriter Create (System.IO.Stream output);

static member Create : System.IO.Stream -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream) As XmlWriter

パラメーター

戻り値

XmlWriter オブジェクト。

例外

例

次の例では、XML フラグメントをメモリ ストリームに書き込みます。 (オーバーロードを使用します Create(Stream, XmlWriterSettings) 。これにより、新しい XML ライター インスタンスの設定も構成されます)。

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

注釈

このオーバーロードを使用すると、XML ライターを XmlWriterSettings 作成するために、次の既定の設定を持つオブジェクトが使用されます。

作成されたライターでサポートする機能を指定する場合は、オブジェクトを引数の 1 つとして受け取り XmlWriterSettings 、カスタム設定で オブジェクトを XmlWriterSettings 渡すオーバーロードを使用します。

また、XmlWriter は常に、基になるデータ ストリームにバイトオーダー マーク (BOM) を書き込みます。ただし、一部のストリームには BOM を含めてはなりません。 BOM を省略するには、新 XmlWriterSettings しいオブジェクトを作成し、Encoding プロパティを新 UTF8Encoding しいオブジェクトに設定し、コンストラクターのブール値を false に設定します。

public:
 static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output);

static member Create : System.Xml.XmlWriter -> System.Xml.XmlWriter

Public Shared Function Create (output As XmlWriter) As XmlWriter

パラメーター

戻り値

指定された XmlWriter オブジェクトをラップする XmlWriter オブジェクト。

例外

注釈

このメソッドを使用すると、基になる XmlWriter オブジェクトに特徴を追加できます。 基になる XmlWriter オブジェクトには、 メソッドによって XmlWriter.Create 作成されたオブジェクト、または 実装を使用して作成されたオブジェクトを XmlTextWriter 指定できます。

このオーバーロードを使用すると、XML ライターを XmlWriterSettings 作成するために、既定の設定を持つ オブジェクトが使用されます。

作成された XML ライターでサポートする機能を指定する場合は、オブジェクトを引数の 1 つとして受け取り XmlWriterSettings 、カスタム設定で XmlWriterSettings オブジェクトを渡すオーバーロードを使用します。