XmlConvert.ToString 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將強型別資料轉換為等效 String 的表示。
多載
ToString(Single)
public:
static System::String ^ ToString(float value);public static string ToString(float value);static member ToString : single -> stringPublic Shared Function ToString (value As Single) As String參數
- value
- Single
要轉換的值。
傳回
一個字串表示。Single
備註
若 value 是 Single.PositiveInfinity 或 Single.NegativeInfinity，則此方法分別回傳字串 INF 或 -INF。
另請參閱
適用於
ToString(TimeSpan)
public:
static System::String ^ ToString(TimeSpan value);public static string ToString(TimeSpan value);static member ToString : TimeSpan -> stringPublic Shared Function ToString (value As TimeSpan) As String參數
- value
- TimeSpan
要轉換的值。
傳回
一個字串表示。TimeSpan
適用於
ToString(UInt16)
重要
此 API 不符合 CLS 規範。
public:
static System::String ^ ToString(System::UInt16 value);[System.CLSCompliant(false)]
public static string ToString(ushort value);[<System.CLSCompliant(false)>]
static member ToString : uint16 -> stringPublic Shared Function ToString (value As UShort) As String參數
- value
- UInt16
要轉換的值。
傳回
一個字串表示。UInt16
- 屬性
適用於
ToString(UInt32)
重要
此 API 不符合 CLS 規範。
public:
static System::String ^ ToString(System::UInt32 value);[System.CLSCompliant(false)]
public static string ToString(uint value);[<System.CLSCompliant(false)>]
static member ToString : uint32 -> stringPublic Shared Function ToString (value As UInteger) As String參數
- value
- UInt32
要轉換的值。
傳回
一個字串表示。UInt32
- 屬性
適用於
ToString(DateTimeOffset, String)
將所提供的 DateTimeOffset 轉換為指定格式的 a String 。
public:
static System::String ^ ToString(DateTimeOffset value, System::String ^ format);public static string ToString(DateTimeOffset value, string format);static member ToString : DateTimeOffset * string -> stringPublic Shared Function ToString (value As DateTimeOffset, format As String) As String參數
- value
- DateTimeOffset
DateTimeOffset他們將被轉化。
- format
- String
格式會被轉換成 value 。 格式參數可以是 W3C 建議中 XML dateTime 類型的任何子集。 （更多資訊請參閱 XML Schema 規範中的 dateTime 章節。）
傳回
以 String 指定格式表示所提供的 DateTimeOffset。
範例
以下範例將 DateTimeOffset 當前時間的表示轉換為指定格式的 a 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)
public:
static System::String ^ ToString(DateTime value, System::String ^ format);public static string ToString(DateTime value, string format);static member ToString : DateTime * string -> stringPublic Shared Function ToString (value As DateTime, format As String) As String參數
- value
- DateTime
要轉換的值。
- format
- String
定義如何顯示轉換後字串的格式結構。 有效的格式包括「yyyy-MM-ddTHH：mm：sszzzzzz」及其子集。
傳回
以指定格式表示的 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();
}
}
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)
利用指定方式DateTime將 轉換為 String aXmlDateTimeSerializationMode。
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 -> stringPublic Shared Function ToString (value As DateTime, dateTimeOption As XmlDateTimeSerializationMode) As String參數
- dateTimeOption
- XmlDateTimeSerializationMode
XmlDateTimeSerializationMode其中一個數值會指定如何處理該DateTime數值。
傳回
例外狀況
這個 dateTimeOption 數值並不成立。
或value值dateTimeOption為 null。
適用於
ToString(SByte)
重要
此 API 不符合 CLS 規範。
public:
static System::String ^ ToString(System::SByte value);[System.CLSCompliant(false)]
public static string ToString(sbyte value);[<System.CLSCompliant(false)>]
static member ToString : sbyte -> stringPublic Shared Function ToString (value As SByte) As String參數
- value
- SByte
要轉換的值。
傳回
一個字串表示。SByte
- 屬性
適用於
ToString(UInt64)
重要
此 API 不符合 CLS 規範。
public:
static System::String ^ ToString(System::UInt64 value);[System.CLSCompliant(false)]
public static string ToString(ulong value);[<System.CLSCompliant(false)>]
static member ToString : uint64 -> stringPublic Shared Function ToString (value As ULong) As String參數
- value
- UInt64
要轉換的值。
傳回
一個字串表示。UInt64
- 屬性
適用於
ToString(Boolean)
public:
static System::String ^ ToString(bool value);public static string ToString(bool value);static member ToString : bool -> stringPublic Shared Function ToString (value As Boolean) As String參數
- value
- Boolean
要轉換的值。
傳回
一個字 Boolean串表示，即「真」或「假」。
適用於
ToString(Int16)
public:
static System::String ^ ToString(short value);public static string ToString(short value);static member ToString : int16 -> stringPublic Shared Function ToString (value As Short) As String參數
- value
- Int16
要轉換的值。
傳回
一個字串表示。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();
}
}
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)
public:
static System::String ^ ToString(Guid value);public static string ToString(Guid value);static member ToString : Guid -> stringPublic Shared Function ToString (value As Guid) As String參數
- value
- Guid
要轉換的值。
傳回
一個字串表示。Guid
適用於
ToString(Double)
public:
static System::String ^ ToString(double value);public static string ToString(double value);static member ToString : double -> stringPublic Shared Function ToString (value As Double) As String參數
- value
- Double
要轉換的值。
傳回
一個字串表示。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();
}
}
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
備註
若 value 是 Double.PositiveInfinity 或 Double.NegativeInfinity，則此方法分別回傳字串 INF 或 -INF。
另請參閱
適用於
ToString(Decimal)
public:
static System::String ^ ToString(System::Decimal value);public static string ToString(decimal value);static member ToString : decimal -> stringPublic Shared Function ToString (value As Decimal) As String參數
- value
- Decimal
要轉換的值。
傳回
一個字串表示。Decimal
適用於
ToString(DateTimeOffset)
將 sserved DateTimeOffsetString轉換為 。
public:
static System::String ^ ToString(DateTimeOffset value);public static string ToString(DateTimeOffset value);static member ToString : DateTimeOffset -> stringPublic Shared Function ToString (value As DateTimeOffset) As String參數
- value
- DateTimeOffset
DateTimeOffset他們將被轉化。
傳回
String所提供的 DateTimeOffset表示。
範例
以下範例將 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)
警告
Use XmlConvert.ToString() that accepts an XmlDateTimeSerializationMode instead.
警告
Use XmlConvert.ToString() that takes in XmlDateTimeSerializationMode
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 takes in XmlDateTimeSerializationMode")]
public static string ToString(DateTime value);public static string ToString(DateTime value);[<System.Obsolete("Use XmlConvert.ToString() that accepts an XmlDateTimeSerializationMode instead.")>]
static member ToString : DateTime -> string[<System.Obsolete("Use XmlConvert.ToString() that takes in XmlDateTimeSerializationMode")>]
static member ToString : DateTime -> stringstatic member ToString : DateTime -> stringPublic Shared Function ToString (value As DateTime) As String參數
- value
- DateTime
要轉換的值。
傳回
以 yyyy-MM-ddTHH：mm：ss 格式表示的 DateTime 字串表示，其中「T」為常數文字。
- 屬性
備註
Note
XmlConvert.ToString(DateTime) 方法在 2.0 版本的 .NET 框架中已過時，並被 XmlConvert.ToString(DateTime, XmlDateTimeSerializationMode) 方法取代。
建議模式為 RoundtripKind。 若預期完全吻合，請使用 XmlConvert.ToString(DateTime, String) 格式字串 yyyy-MM-ddTHH:mm:ss.fffffffzzzzzz。
適用於
ToString(Char)
public:
static System::String ^ ToString(char value);public static string ToString(char value);static member ToString : char -> stringPublic Shared Function ToString (value As Char) As String參數
- value
- Char
要轉換的值。
傳回
一個字串表示。Char
適用於
ToString(Byte)
public:
static System::String ^ ToString(System::Byte value);public static string ToString(byte value);static member ToString : byte -> stringPublic Shared Function ToString (value As Byte) As String參數
- value
- Byte
要轉換的值。
傳回
一個字串表示。Byte
