この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

XmlWriterSettings.Encoding プロパティ

 

公開日: 2016年10月

使用するテキスト エンコーディングの種類を取得または設定します。

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

public Encoding Encoding { get; set; }

プロパティ値

Type: System.Text.Encoding

使用するテキスト エンコーディング。 既定値は、Encoding.UTF8 です。

The T:System.Xml.XmlWriter encodes a buffer of characters all at once, rather than character by character. An exception is thrown when the M:System.Xml.XmlWriter.Flush method is called if any encoding errors are encountered.

The P:System.Xml.XmlWriterSettings.Encoding property only applies to the T:System.Xml.XmlWriter instances that are created either with the specified T:System.IO.Stream or with the specified file name. If the T:System.Xml.XmlWriter instance is created with the specified T:System.IO.TextWriter, the P:System.Xml.XmlWriterSettings.Encoding property is overridden by the encoding of the underlying T:System.IO.TextWriter. For example, if this property is set to Unicode (UTF-16) for a particular T:System.Xml.XmlWriter, but the underlying writer is a T:System.IO.StreamWriter (which derives from T:System.IO.TextWriter) with its encoding set to UTF8, the output will be UTF-8 encoded.

If the T:System.Xml.XmlWriter instance is created with other output parameters, the P:System.Xml.XmlWriterSettings.Encoding property is ignored.

In the following example:

  • The default value of P:System.Xml.XmlWriterSettings.Encoding is Encoding.UTF8.

  • The T:System.IO.StreamWriter is set to Encoding.Unicode and the T:System.IO.StreamWriter’s encoding overrides the P:System.Xml.XmlWriterSettings.Encoding setting.

  • The output will be Encoding.Unicode.

using (StreamWriter output =
    new StreamWriter(new FileStream("Xml01.xml", FileMode.Create), Encoding.Unicode))
{
    using (XmlWriter xmlWriter =
        XmlWriter.Create(output, new XmlWriterSettings()))
    {
        xmlWriter.WriteStartDocument();
        xmlWriter.WriteStartElement("Root");
        xmlWriter.WriteEndElement();
        xmlWriter.WriteEndDocument();
    }
}
System_CAPS_security セキュリティ メモ

Do not accept an T:System.Text.Encoding object from an untrusted source.

The following example writes an XML fragment to a memory stream.

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 additonal processing on the stream.

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
2.0 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Silverlight
2.0 以降で使用可能
Windows Phone Silverlight
7.0 以降で使用可能
Windows Phone
8.1 以降で使用可能
トップに戻る
表示: