XmlConvert.ToString メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

厳密に型指定されたデータを等価の String 形式に変換します。

オーバーロード

ToString(Single)	Single を String に変換します。
ToString(TimeSpan)	TimeSpan を String に変換します。
ToString(UInt16)	UInt16 を String に変換します。
ToString(UInt32)	UInt32 を String に変換します。
ToString(DateTimeOffset, String)	指定した DateTimeOffset を指定した形式の String に変換します。
ToString(DateTime, String)	DateTime を String に変換します。
ToString(DateTime, XmlDateTimeSerializationMode)	指定された XmlDateTimeSerializationMode を使用して、DateTime を String に変換します。
ToString(SByte)	SByte を String に変換します。
ToString(UInt64)	UInt64 を String に変換します。
ToString(Int64)	Int64 を String に変換します。
ToString(Boolean)	Boolean を String に変換します。
ToString(Int16)	Int16 を String に変換します。
ToString(Guid)	Guid を String に変換します。
ToString(Double)	Double を String に変換します。
ToString(Decimal)	Decimal を String に変換します。
ToString(DateTimeOffset)	指定した DateTimeOffset を String に変換します。
ToString(DateTime)	古い. DateTime を String に変換します。
ToString(Char)	Char を String に変換します。
ToString(Byte)	Byte を String に変換します。
ToString(Int32)	Int32 を String に変換します。

ToString(Single)

ソース:

XmlConvert.cs

Single を String に変換します。

public static string ToString (float value);

パラメーター

value

Single

変換する値。

戻り値

String

Single の文字列形式。

注釈

が Single.PositiveInfinity または Single.NegativeInfinity の場合 value 、このメソッドは文字列 INF または -INF をそれぞれ返します。

こちらもご覧ください

• PositiveInfinity
• NegativeInfinity

ToString(TimeSpan)

ソース:

XmlConvert.cs

TimeSpan を String に変換します。

public static string ToString (TimeSpan value);

パラメーター

value

TimeSpan

変換する値。

戻り値

String

TimeSpan の文字列形式。

ToString(UInt16)

ソース:

XmlConvert.cs

重要

この API は CLS 準拠ではありません。

UInt16 を String に変換します。

[System.CLSCompliant(false)]
public static string ToString (ushort value);

パラメーター

value

UInt16

変換する値。

戻り値

String

UInt16 の文字列形式。

属性

CLSCompliantAttribute

ToString(UInt32)

ソース:

XmlConvert.cs

重要

この API は CLS 準拠ではありません。

UInt32 を String に変換します。

[System.CLSCompliant(false)]
public static string ToString (uint value);

パラメーター

value

UInt32

変換する値。

戻り値

String

UInt32 の文字列形式。

属性

CLSCompliantAttribute

ToString(DateTimeOffset, String)

ソース:

XmlConvert.cs

指定した DateTimeOffset を指定した形式の String に変換します。

public static string ToString (DateTimeOffset value, string format);

パラメーター

value

DateTimeOffset

変換される DateTimeOffset。

format

String

変換後の s の形式。 フォーマット パラメーターには、W3C 勧告の XML dateTime 型の任意のサブセットを指定できます。 (詳細については、XML スキーマ仕様の dateTime セクションを参照してください。)

戻り値

String

指定した DateTimeOffset の指定した形式での String 表現。

例

次の例では、 DateTimeOffset 現在の時刻 String の表現を、指定した形式の に変換します。

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create the DateTimeOffset object and set the time to the current time.
        DateTimeOffset dto;
        dto = DateTimeOffset.Now;

        // Convert the DateTimeObject to a string in a specified format and display the result.
        // The specified format must be a subset of the W3C Recommendation for the XML dateTime type.
        String timeAsString = XmlConvert.ToString(dto, "yyyy-MM-ddTHH:mm:sszzzzzzz");
        Console.WriteLine(timeAsString);
    }
}

ToString(DateTime, String)

ソース:

XmlConvert.cs

DateTime を String に変換します。

public static string ToString (DateTime value, string format);

パラメーター

value

DateTime

変換する値。

format

String

変換後の文字列の表示方法を定義する形式構造。 有効な形式には、"yyyy-MM-ddTHH:mm:sszzzzzz" およびそのサブセットが含まれます。

戻り値

String

指定した形式での DateTime の文字列形式。

例

次の例では、データ型を文字列に変換し、情報をコンソールに書き込みます。

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

public class Sample
{
  public static void Main()
  {

    //Define the order data.  They will be converted to string
    //before being written out.
    Int16 custID = 32632;
    String orderID = "367A54";
    DateTime orderDate = new DateTime();
    orderDate = DateTime.Now;
    Double price = 19.95;

    //Create a writer that outputs to the console.
    XmlTextWriter writer = new XmlTextWriter (Console.Out);
    writer.Formatting = Formatting.Indented;

    //Write an element (this one is the root)
    writer.WriteStartElement("order");

    //Write the order date.
    writer.WriteAttributeString("date", XmlConvert.ToString(orderDate, "yyyy-MM-dd"));

    //Write the order time.
    writer.WriteAttributeString("time", XmlConvert.ToString(orderDate, "HH:mm:ss"));

    //Write the order data.
    writer.WriteElementString("orderID", orderID);
    writer.WriteElementString("custID", XmlConvert.ToString(custID));
    writer.WriteElementString("price", XmlConvert.ToString(price));

    //Write the close tag for the root element
    writer.WriteEndElement();

    //Write the XML and close the writer
    writer.Close();
  }
}

ToString(DateTime, XmlDateTimeSerializationMode)

ソース:

XmlConvert.cs

指定された XmlDateTimeSerializationMode を使用して、DateTime を String に変換します。

public static string ToString (DateTime value, System.Xml.XmlDateTimeSerializationMode dateTimeOption);

パラメーター

value

DateTime

変換する DateTime 値。

dateTimeOption

XmlDateTimeSerializationMode

DateTime 値を処理する方法を指定する XmlDateTimeSerializationMode 値の 1 つ。

戻り値

String

DateTime と等価の String。

例外

ArgumentException

dateTimeOption 値が有効ではありません。

ArgumentNullException

value または dateTimeOption の値が null です。

ToString(SByte)

ソース:

XmlConvert.cs

重要

この API は CLS 準拠ではありません。

SByte を String に変換します。

[System.CLSCompliant(false)]
public static string ToString (sbyte value);

パラメーター

value

SByte

変換する値。

戻り値

String

SByte の文字列形式。

属性

CLSCompliantAttribute

ToString(UInt64)

ソース:

XmlConvert.cs

重要

この API は CLS 準拠ではありません。

UInt64 を String に変換します。

[System.CLSCompliant(false)]
public static string ToString (ulong value);

パラメーター

value

UInt64

変換する値。

戻り値

String

UInt64 の文字列形式。

属性

CLSCompliantAttribute

ToString(Int64)

ソース:

XmlConvert.cs

Int64 を String に変換します。

public static string ToString (long value);

パラメーター

value

Int64

変換する値。

戻り値

String

Int64 の文字列形式。

ToString(Boolean)

ソース:

XmlConvert.cs

Boolean を String に変換します。

public static string ToString (bool value);

パラメーター

value

Boolean

変換する値。

戻り値

String

Boolean の文字列形式。つまり "true" または "false"。

ToString(Int16)

ソース:

XmlConvert.cs

Int16 を String に変換します。

public static string ToString (short value);

パラメーター

value

Int16

変換する値。

戻り値

String

Int16 の文字列形式。

例

次の例では、データ型を文字列に変換し、情報をコンソールに書き込みます。

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

public class Sample
{
  public static void Main()
  {

    //Define the order data.  They will be converted to string
    //before being written out.
    Int16 custID = 32632;
    String orderID = "367A54";
    DateTime orderDate = new DateTime();
    orderDate = DateTime.Now;
    Double price = 19.95;

    //Create a writer that outputs to the console.
    XmlTextWriter writer = new XmlTextWriter (Console.Out);
    writer.Formatting = Formatting.Indented;

    //Write an element (this one is the root)
    writer.WriteStartElement("order");

    //Write the order date.
    writer.WriteAttributeString("date", XmlConvert.ToString(orderDate, "yyyy-MM-dd"));

    //Write the order time.
    writer.WriteAttributeString("time", XmlConvert.ToString(orderDate, "HH:mm:ss"));

    //Write the order data.
    writer.WriteElementString("orderID", orderID);
    writer.WriteElementString("custID", XmlConvert.ToString(custID));
    writer.WriteElementString("price", XmlConvert.ToString(price));

    //Write the close tag for the root element
    writer.WriteEndElement();

    //Write the XML and close the writer
    writer.Close();
  }
}

ToString(Guid)

ソース:

XmlConvert.cs

Guid を String に変換します。

public static string ToString (Guid value);

パラメーター

value

Guid

変換する値。

戻り値

String

Guid の文字列形式。

ToString(Double)

ソース:

XmlConvert.cs

Double を String に変換します。

public static string ToString (double value);

パラメーター

value

Double

変換する値。

戻り値

String

Double の文字列形式。

例

次の例では、データ型を文字列に変換し、情報をコンソールに書き込みます。

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

public class Sample
{
  public static void Main()
  {

    //Define the order data.  They will be converted to string
    //before being written out.
    Int16 custID = 32632;
    String orderID = "367A54";
    DateTime orderDate = new DateTime();
    orderDate = DateTime.Now;
    Double price = 19.95;

    //Create a writer that outputs to the console.
    XmlTextWriter writer = new XmlTextWriter (Console.Out);
    writer.Formatting = Formatting.Indented;

    //Write an element (this one is the root)
    writer.WriteStartElement("order");

    //Write the order date.
    writer.WriteAttributeString("date", XmlConvert.ToString(orderDate, "yyyy-MM-dd"));

    //Write the order time.
    writer.WriteAttributeString("time", XmlConvert.ToString(orderDate, "HH:mm:ss"));

    //Write the order data.
    writer.WriteElementString("orderID", orderID);
    writer.WriteElementString("custID", XmlConvert.ToString(custID));
    writer.WriteElementString("price", XmlConvert.ToString(price));

    //Write the close tag for the root element
    writer.WriteEndElement();

    //Write the XML and close the writer
    writer.Close();
  }
}

注釈

が Double.PositiveInfinity または Double.NegativeInfinity の場合 value 、このメソッドは文字列 INF または -INF をそれぞれ返します。

こちらもご覧ください

• PositiveInfinity
• NegativeInfinity

ToString(Decimal)

ソース:

XmlConvert.cs

Decimal を String に変換します。

public static string ToString (decimal value);

パラメーター

value

Decimal

変換する値。

戻り値

String

Decimal の文字列形式。

ToString(DateTimeOffset)

ソース:

XmlConvert.cs

指定した DateTimeOffset を String に変換します。

public static string ToString (DateTimeOffset value);

パラメーター

value

DateTimeOffset

変換される DateTimeOffset。

戻り値

String

指定した DateTimeOffset の String 表現。

例

次の例では、 DateTimeOffset 現在の時刻の表現を に String変換します。

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create the DateTimeOffset object and set the time to the current time
        DateTimeOffset dto;
        dto = DateTimeOffset.Now;

        // Convert the DateTimeOffset object to a string and display the result
        string timeAsString = XmlConvert.ToString(dto);
        Console.WriteLine(timeAsString);
    }
}

ToString(DateTime)

ソース:

XmlConvert.cs

注意事項

Use XmlConvert.ToString() that accepts an XmlDateTimeSerializationMode instead.

DateTime を String に変換します。

[System.Obsolete("Use XmlConvert.ToString() that accepts an XmlDateTimeSerializationMode instead.")]
public static string ToString (DateTime value);

パラメーター

value

DateTime

変換する値。

戻り値

String

yyyy-MM-ddTHH:mm:ss の形式での DateTime の文字列形式。'T' は定数リテラル。

属性

ObsoleteAttribute

注釈

注意

メソッドはXmlConvert.ToString(DateTime)、.NET Frameworkの 2.0 バージョンでは古く、メソッドにXmlConvert.ToString(DateTime, XmlDateTimeSerializationMode)置き換えられました。 推奨されるモードは です RoundtripKind。 完全一致が必要な場合は、書式指定文字列 yyyy-MM-ddTHH:mm:ss.fffffffzzzzzzと共に を使用XmlConvert.ToString(DateTime, String)してください。

ToString(Char)

ソース:

XmlConvert.cs

Char を String に変換します。

public static string ToString (char value);

パラメーター

value

Char

変換する値。

戻り値

String

Char の文字列形式。

ToString(Byte)

ソース:

XmlConvert.cs

Byte を String に変換します。

public static string ToString (byte value);

パラメーター

value

Byte

変換する値。

戻り値

String

Byte の文字列形式。

ToString(Int32)

ソース:

XmlConvert.cs

Int32 を String に変換します。

public static string ToString (int value);

パラメーター

value

Int32

変換する値。

戻り値

String

Int32 の文字列形式。