XmlConvert.ToString Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Převede data silného typu na ekvivalentní String reprezentaci.

Přetížení

Name	Description
ToString(Single)	Převede na Single .String
ToString(TimeSpan)	Převede na TimeSpan .String
ToString(UInt16)	Převede na UInt16 .String
ToString(UInt32)	Převede na UInt32 .String
ToString(DateTimeOffset, String)	Převede zadaný DateTimeOffset formát na zadaný String formát.
ToString(DateTime, String)	Převede na DateTime .String
ToString(DateTime, XmlDateTimeSerializationMode)	Převede na DateTime zadanou metodu StringXmlDateTimeSerializationMode.
ToString(SByte)	Převede na SByte .String
ToString(UInt64)	Převede na UInt64 .String
ToString(Int64)	Převede na Int64 .String
ToString(Boolean)	Převede na Boolean .String
ToString(Int16)	Převede na Int16 .String
ToString(Guid)	Převede na Guid .String
ToString(Double)	Převede na Double .String
ToString(Decimal)	Převede na Decimal .String
ToString(DateTimeOffset)	Převede zadané DateTimeOffset na .String
ToString(DateTime)	Zastaralé. Převede na DateTime .String
ToString(Char)	Převede na Char .String
ToString(Byte)	Převede na Byte .String
ToString(Int32)	Převede na Int32 .String

ToString(Single)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Single

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Single.

Poznámky

Pokud value je Single.PositiveInfinity nebo Single.NegativeInfinity, tato metoda vrátí řetězec INF nebo -INF v uvedeném pořadí.

Viz také

• PositiveInfinity
• NegativeInfinity

ToString(TimeSpan)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

TimeSpan

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace TimeSpan.

ToString(UInt16)

Zdroj:

XmlConvert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Převede na 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

Parametry

value

UInt16

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace UInt16.

Atributy

CLSCompliantAttribute

ToString(UInt32)

Zdroj:

XmlConvert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Převede na 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

Parametry

value

UInt32

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace UInt32.

Atributy

CLSCompliantAttribute

ToString(DateTimeOffset, String)

Zdroj:

XmlConvert.cs

Převede zadaný DateTimeOffset formát na zadaný String formát.

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

Parametry

value

DateTimeOffset

Hodnota DateTimeOffset , která se má převést.

format

String

Formát, na který value je převeden. Parametr formátu může být libovolnou podmnožinou doporučení W3C pro typ dateTime XML. (Další informace naleznete v části dateTime specifikace schématu XML.)

Návraty

String

Reprezentace String v zadaném formátu zadaného DateTimeOffsetsouboru .

Příklady

Následující příklad převede DateTimeOffset reprezentaci aktuálního času na v String zadaném formátu.

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)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

DateTime

Hodnota, kterou chcete převést.

format

String

Struktura formátu, která definuje, jak zobrazit převedený řetězec. Platné formáty zahrnují "yyyy-MM-ddTHH:mm:sszzzzzz" a jeho podmnožiny.

Návraty

String

Řetězcová reprezentace DateTime v zadaném formátu.

Příklady

Následující příklad převede datové typy na řetězec a potom zapíše informace do konzoly.

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)

Zdroj:

XmlConvert.cs

Převede na DateTime zadanou metodu StringXmlDateTimeSerializationMode.

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

Parametry

value

DateTime

Hodnota DateTime , kterou chcete převést.

dateTimeOption

XmlDateTimeSerializationMode

Jedna zhodnotýchch XmlDateTimeSerializationModeDateTime

Návraty

String

Ekvivalentem StringDateTime.

Výjimky

ArgumentException

Hodnota dateTimeOption není platná.

ArgumentNullException

Hodnota value nebo dateTimeOption hodnota je null.

ToString(SByte)

Zdroj:

XmlConvert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Převede na 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

Parametry

value

SByte

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace SByte.

Atributy

CLSCompliantAttribute

ToString(UInt64)

Zdroj:

XmlConvert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Převede na 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

Parametry

value

UInt64

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace UInt64.

Atributy

CLSCompliantAttribute

ToString(Int64)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Int64

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Int64.

ToString(Boolean)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Boolean

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová Booleanreprezentace , tj. "true" nebo "false".

ToString(Int16)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Int16

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Int16.

Příklady

Následující příklad převede datové typy na řetězec a potom zapíše informace do konzoly.

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)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Guid

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Guid.

ToString(Double)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Double

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Double.

Příklady

Následující příklad převede datové typy na řetězec a potom zapíše informace do konzoly.

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

Poznámky

Pokud value je Double.PositiveInfinity nebo Double.NegativeInfinity, tato metoda vrátí řetězec INF nebo -INF v uvedeném pořadí.

Viz také

• PositiveInfinity
• NegativeInfinity

ToString(Decimal)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Decimal

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Decimal.

ToString(DateTimeOffset)

Zdroj:

XmlConvert.cs

Převede zadané DateTimeOffset na .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

Parametry

value

DateTimeOffset

Hodnota DateTimeOffset , která se má převést.

Návraty

String

Reprezentace String dodaného DateTimeOffsetsouboru .

Příklady

Následující příklad převede DateTimeOffset reprezentaci aktuálního času na .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)

Zdroj:

XmlConvert.cs

Upozornění

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

Převede na 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

Parametry

value

DateTime

Hodnota, kterou chcete převést.

Návraty

String

Řetězcové DateTime vyjádření ve formátu rrrr-MM-ddTHH:mm:ss, kde "T" je konstantní literál.

Atributy

ObsoleteAttribute

Poznámky

Note

Metoda XmlConvert.ToString(DateTime) je zastaralá ve verzi 2.0 .NET Framework a byla nahrazena metodou XmlConvert.ToString(DateTime, XmlDateTimeSerializationMode). Navrhovaný režim je RoundtripKind. Pokud se očekává přesná shoda, použijte XmlConvert.ToString(DateTime, String) řetězec formátu yyyy-MM-ddTHH:mm:ss.fffffffzzzzzz.

ToString(Char)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Char

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Char.

ToString(Byte)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Byte

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Byte.

ToString(Int32)

Zdroj:

XmlConvert.cs

Převede na 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

Parametry

value

Int32

Hodnota, kterou chcete převést.

Návraty

String

Řetězcová reprezentace Int32.