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 System::String ^ ToString(float value);

public static string ToString (float value);

static member ToString : single -> string

Public Shared Function ToString (value As Single) As String

パラメーター

value

Single

変換する値。

戻り値

String

Single の文字列形式。

注釈

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

こちらもご覧ください

• PositiveInfinity
• NegativeInfinity

ToString(TimeSpan)

ソース:

XmlConvert.cs

TimeSpan を String に変換します。

public:
 static System::String ^ ToString(TimeSpan value);

public static string ToString (TimeSpan value);

static member ToString : TimeSpan -> string

Public Shared Function ToString (value As TimeSpan) As String

パラメーター

value

TimeSpan

変換する値。

戻り値

String

TimeSpan の文字列形式。

ToString(UInt16)

ソース:

XmlConvert.cs

重要

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

UInt16 を String に変換します。

public:
 static System::String ^ ToString(System::UInt16 value);

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

[<System.CLSCompliant(false)>]
static member ToString : uint16 -> string

Public Shared Function ToString (value As UShort) As String

パラメーター

value

UInt16

変換する値。

戻り値

String

UInt16 の文字列形式。

属性

CLSCompliantAttribute

ToString(UInt32)

ソース:

XmlConvert.cs

重要

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

UInt32 を String に変換します。

public:
 static System::String ^ ToString(System::UInt32 value);

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

[<System.CLSCompliant(false)>]
static member ToString : uint32 -> string

Public Shared Function ToString (value As UInteger) As String

パラメーター

value

UInt32

変換する値。

戻り値

String

UInt32 の文字列形式。

属性

CLSCompliantAttribute

ToString(DateTimeOffset, String)

ソース:

XmlConvert.cs

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

public:
 static System::String ^ ToString(DateTimeOffset value, System::String ^ format);

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

static member ToString : DateTimeOffset * string -> string

Public Shared Function ToString (value As DateTimeOffset, format As String) As String

パラメーター

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);
    }
}

Imports System.Xml

Module Module1
    Sub Main()

        ' Create the DateTimeOffset object and set the time to the current time.
        Dim dto As DateTimeOffset
        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.
        Dim timeAsString As [String] = XmlConvert.ToString(dto, "yyyy-MM-ddTHH:mm:sszzzzzzz")
        Console.WriteLine(timeAsString)

    End Sub
End Module

ToString(DateTime, String)

ソース:

XmlConvert.cs

DateTime を String に変換します。

public:
 static System::String ^ ToString(DateTime value, System::String ^ format);

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

static member ToString : DateTime * string -> string

Public Shared Function ToString (value As DateTime, format As String) As String

パラメーター

value

DateTime

変換する値。

format

String

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

戻り値

String

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

例

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Define the order data.  They will be converted to string 
   //before being written out.
   Int16 custID = 32632;
   String^ orderID = "367A54";
   DateTime orderDate = DateTime::Now;
   Double price = 19.95;
   
   //Create a writer that outputs to the console.
   XmlTextWriter^ writer = gcnew 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();
}

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();
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    'Define the order data.  They will be converted to string
    'before being written out.
    Dim custID as Int16 = 32632
    Dim orderID as String = "367A54"
    Dim orderDate as DateTime 
    orderDate = DateTime.Now
    Dim price as Double = 19.95

    'Create a writer that outputs to the console.
    Dim writer as XmlTextWriter = new XmlTextWriter (Console.Out)
    'Use indenting for readability
    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.Flush()
    writer.Close()  

  end sub
end class

ToString(DateTime, XmlDateTimeSerializationMode)

ソース:

XmlConvert.cs

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

public:
 static System::String ^ ToString(DateTime value, System::Xml::XmlDateTimeSerializationMode dateTimeOption);

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

static member ToString : DateTime * System.Xml.XmlDateTimeSerializationMode -> string

Public Shared Function ToString (value As DateTime, dateTimeOption As XmlDateTimeSerializationMode) As String

パラメーター

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 に変換します。

public:
 static System::String ^ ToString(System::SByte value);

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

[<System.CLSCompliant(false)>]
static member ToString : sbyte -> string

Public Shared Function ToString (value As SByte) As String

パラメーター

value

SByte

変換する値。

戻り値

String

SByte の文字列形式。

属性

CLSCompliantAttribute

ToString(UInt64)

ソース:

XmlConvert.cs

重要

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

UInt64 を String に変換します。

public:
 static System::String ^ ToString(System::UInt64 value);

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

[<System.CLSCompliant(false)>]
static member ToString : uint64 -> string

Public Shared Function ToString (value As ULong) As String

パラメーター

value

UInt64

変換する値。

戻り値

String

UInt64 の文字列形式。

属性

CLSCompliantAttribute

ToString(Int64)

ソース:

XmlConvert.cs

Int64 を String に変換します。

public:
 static System::String ^ ToString(long value);

public static string ToString (long value);

static member ToString : int64 -> string

Public Shared Function ToString (value As Long) As String

パラメーター

value

Int64

変換する値。

戻り値

String

Int64 の文字列形式。

ToString(Boolean)

ソース:

XmlConvert.cs

Boolean を String に変換します。

public:
 static System::String ^ ToString(bool value);

public static string ToString (bool value);

static member ToString : bool -> string

Public Shared Function ToString (value As Boolean) As String

パラメーター

value

Boolean

変換する値。

戻り値

String

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

ToString(Int16)

ソース:

XmlConvert.cs

Int16 を String に変換します。

public:
 static System::String ^ ToString(short value);

public static string ToString (short value);

static member ToString : int16 -> string

Public Shared Function ToString (value As Short) As String

パラメーター

value

Int16

変換する値。

戻り値

String

Int16 の文字列形式。

例

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Define the order data.  They will be converted to string 
   //before being written out.
   Int16 custID = 32632;
   String^ orderID = "367A54";
   DateTime orderDate = DateTime::Now;
   Double price = 19.95;
   
   //Create a writer that outputs to the console.
   XmlTextWriter^ writer = gcnew 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();
}

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();
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    'Define the order data.  They will be converted to string
    'before being written out.
    Dim custID as Int16 = 32632
    Dim orderID as String = "367A54"
    Dim orderDate as DateTime 
    orderDate = DateTime.Now
    Dim price as Double = 19.95

    'Create a writer that outputs to the console.
    Dim writer as XmlTextWriter = new XmlTextWriter (Console.Out)
    'Use indenting for readability
    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.Flush()
    writer.Close()  

  end sub
end class

ToString(Guid)

ソース:

XmlConvert.cs

Guid を String に変換します。

public:
 static System::String ^ ToString(Guid value);

public static string ToString (Guid value);

static member ToString : Guid -> string

Public Shared Function ToString (value As Guid) As String

パラメーター

value

Guid

変換する値。

戻り値

String

Guid の文字列形式。

ToString(Double)

ソース:

XmlConvert.cs

Double を String に変換します。

public:
 static System::String ^ ToString(double value);

public static string ToString (double value);

static member ToString : double -> string

Public Shared Function ToString (value As Double) As String

パラメーター

value

Double

変換する値。

戻り値

String

Double の文字列形式。

例

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Define the order data.  They will be converted to string 
   //before being written out.
   Int16 custID = 32632;
   String^ orderID = "367A54";
   DateTime orderDate = DateTime::Now;
   Double price = 19.95;
   
   //Create a writer that outputs to the console.
   XmlTextWriter^ writer = gcnew 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();
}

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();
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    'Define the order data.  They will be converted to string
    'before being written out.
    Dim custID as Int16 = 32632
    Dim orderID as String = "367A54"
    Dim orderDate as DateTime 
    orderDate = DateTime.Now
    Dim price as Double = 19.95

    'Create a writer that outputs to the console.
    Dim writer as XmlTextWriter = new XmlTextWriter (Console.Out)
    'Use indenting for readability
    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.Flush()
    writer.Close()  

  end sub
end class

注釈

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

こちらもご覧ください

• PositiveInfinity
• NegativeInfinity

ToString(Decimal)

ソース:

XmlConvert.cs

Decimal を String に変換します。

public:
 static System::String ^ ToString(System::Decimal value);

public static string ToString (decimal value);

static member ToString : decimal -> string

Public Shared Function ToString (value As Decimal) As String

パラメーター

value

Decimal

変換する値。

戻り値

String

Decimal の文字列形式。

ToString(DateTimeOffset)

ソース:

XmlConvert.cs

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

public:
 static System::String ^ ToString(DateTimeOffset value);

public static string ToString (DateTimeOffset value);

static member ToString : DateTimeOffset -> string

Public Shared Function ToString (value As DateTimeOffset) As String

パラメーター

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);
    }
}

Imports System.Xml

Module Module1
    Sub Main()

        ' Create the DateTimeOffset object and set the time to the current time
        Dim dto As DateTimeOffset
        dto = DateTimeOffset.Now

        ' Convert the DateTimeOffset object to a string and display the result
        Dim timeAsString As String = XmlConvert.ToString(dto)
        Console.WriteLine(timeAsString)

    End Sub
End Module

ToString(DateTime)

ソース:

XmlConvert.cs

注意事項

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

DateTime を String に変換します。

public:
 static System::String ^ ToString(DateTime value);

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

[<System.Obsolete("Use XmlConvert.ToString() that accepts an XmlDateTimeSerializationMode instead.")>]
static member ToString : DateTime -> string

Public Shared Function ToString (value As DateTime) As String

パラメーター

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 System::String ^ ToString(char value);

public static string ToString (char value);

static member ToString : char -> string

Public Shared Function ToString (value As Char) As String

パラメーター

value

Char

変換する値。

戻り値

String

Char の文字列形式。

ToString(Byte)

ソース:

XmlConvert.cs

Byte を String に変換します。

public:
 static System::String ^ ToString(System::Byte value);

public static string ToString (byte value);

static member ToString : byte -> string

Public Shared Function ToString (value As Byte) As String

パラメーター

value

Byte

変換する値。

戻り値

String

Byte の文字列形式。

ToString(Int32)

ソース:

XmlConvert.cs

Int32 を String に変換します。

public:
 static System::String ^ ToString(int value);

public static string ToString (int value);

static member ToString : int -> string

Public Shared Function ToString (value As Integer) As String

パラメーター

value

Int32

変換する値。

戻り値

String

Int32 の文字列形式。