XmlConvert.ToString Metodo

Definizione

Converte i dati fortemente tipizzato in una rappresentazione equivalente String .

Overload

Nome Descrizione
ToString(Single)

Converte l'oggetto in Single un oggetto String.

ToString(TimeSpan)

Converte l'oggetto in TimeSpan un oggetto String.

ToString(UInt16)

Converte l'oggetto in UInt16 un oggetto String.

ToString(UInt32)

Converte l'oggetto in UInt32 un oggetto String.

ToString(DateTimeOffset, String)

Converte l'oggetto fornito DateTimeOffset in un String oggetto nel formato specificato.

ToString(DateTime, String)

Converte l'oggetto in DateTime un oggetto String.

ToString(DateTime, XmlDateTimeSerializationMode)

Converte in DateTime un String oggetto utilizzando l'oggetto XmlDateTimeSerializationMode specificato.

ToString(SByte)

Converte l'oggetto in SByte un oggetto String.

ToString(UInt64)

Converte l'oggetto in UInt64 un oggetto String.

ToString(Int64)

Converte l'oggetto in Int64 un oggetto String.

ToString(Boolean)

Converte l'oggetto in Boolean un oggetto String.

ToString(Int16)

Converte l'oggetto in Int16 un oggetto String.

ToString(Guid)

Converte l'oggetto in Guid un oggetto String.

ToString(Double)

Converte l'oggetto in Double un oggetto String.

ToString(Decimal)

Converte l'oggetto in Decimal un oggetto String.

ToString(DateTimeOffset)

Converte l'oggetto fornito DateTimeOffset in un oggetto String.

ToString(DateTime)
Obsoleti.

Converte l'oggetto in DateTime un oggetto String.

ToString(Char)

Converte l'oggetto in Char un oggetto String.

ToString(Byte)

Converte l'oggetto in Byte un oggetto String.

ToString(Int32)

Converte l'oggetto in Int32 un oggetto String.

ToString(Single)

Converte l'oggetto in Single un oggetto 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

Parametri

value
Single

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Single.

Commenti

Se value è Single.PositiveInfinity o Single.NegativeInfinity, questo metodo restituisce rispettivamente la stringa INF o -INF.

Vedi anche

Si applica a

ToString(TimeSpan)

Converte l'oggetto in TimeSpan un oggetto 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

Parametri

value
TimeSpan

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto TimeSpan.

Si applica a

ToString(UInt16)

Importante

Questa API non è conforme a CLS.

Converte l'oggetto in UInt16 un oggetto 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

Parametri

value
UInt16

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto UInt16.

Attributi

Si applica a

ToString(UInt32)

Importante

Questa API non è conforme a CLS.

Converte l'oggetto in UInt32 un oggetto 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

Parametri

value
UInt32

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto UInt32.

Attributi

Si applica a

ToString(DateTimeOffset, String)

Converte l'oggetto fornito DateTimeOffset in un String oggetto nel formato specificato.

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

Parametri

value
DateTimeOffset

Oggetto DateTimeOffset da convertire.

format
String

Formato in cui value viene convertito. Il parametro format può essere qualsiasi subset della raccomandazione W3C per il tipo dateTime XML. Per altre informazioni, vedere la sezione dateTime della specifica xml Schema.

Valori restituiti

Rappresentazione String nel formato specificato dell'oggetto DateTimeOffsetfornito.

Esempio

Nell'esempio seguente viene convertita una DateTimeOffset rappresentazione dell'ora corrente in un String oggetto nel formato specificato.

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

Si applica a

ToString(DateTime, String)

Converte l'oggetto in DateTime un oggetto 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

Parametri

value
DateTime

Valore da convertire.

format
String

Struttura di formato che definisce come visualizzare la stringa convertita. I formati validi includono "aaaa-MM-ggTHH:mm:sszzzzzz" e i relativi subset.

Valori restituiti

Rappresentazione di stringa dell'oggetto DateTime nel formato specificato.

Esempio

L'esempio seguente converte i tipi di dati in stringa e quindi scrive le informazioni nella console.

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

Si applica a

ToString(DateTime, XmlDateTimeSerializationMode)

Converte in DateTime un String oggetto utilizzando l'oggetto XmlDateTimeSerializationMode specificato.

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

Parametri

value
DateTime

Valore DateTime da convertire.

dateTimeOption
XmlDateTimeSerializationMode

Uno dei XmlDateTimeSerializationMode valori che specificano come trattare il DateTime valore.

Valori restituiti

Equivalente String all'oggetto DateTime.

Eccezioni

Il dateTimeOption valore non è valido.

Il value valore o dateTimeOption è null.

Si applica a

ToString(SByte)

Importante

Questa API non è conforme a CLS.

Converte l'oggetto in SByte un oggetto 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

Parametri

value
SByte

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto SByte.

Attributi

Si applica a

ToString(UInt64)

Importante

Questa API non è conforme a CLS.

Converte l'oggetto in UInt64 un oggetto 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

Parametri

value
UInt64

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto UInt64.

Attributi

Si applica a

ToString(Int64)

Converte l'oggetto in Int64 un oggetto 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

Parametri

value
Int64

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Int64.

Si applica a

ToString(Boolean)

Converte l'oggetto in Boolean un oggetto 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

Parametri

value
Boolean

Valore da convertire.

Valori restituiti

Rappresentazione di stringa di Boolean, ovvero "true" o "false".

Si applica a

ToString(Int16)

Converte l'oggetto in Int16 un oggetto 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

Parametri

value
Int16

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Int16.

Esempio

L'esempio seguente converte i tipi di dati in stringa e quindi scrive le informazioni nella console.

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

Si applica a

ToString(Guid)

Converte l'oggetto in Guid un oggetto 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

Parametri

value
Guid

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Guid.

Si applica a

ToString(Double)

Converte l'oggetto in Double un oggetto 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

Parametri

value
Double

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Double.

Esempio

L'esempio seguente converte i tipi di dati in stringa e quindi scrive le informazioni nella console.

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

Commenti

Se value è Double.PositiveInfinity o Double.NegativeInfinity, questo metodo restituisce rispettivamente la stringa INF o -INF.

Vedi anche

Si applica a

ToString(Decimal)

Converte l'oggetto in Decimal un oggetto 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

Parametri

value
Decimal

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Decimal.

Si applica a

ToString(DateTimeOffset)

Converte l'oggetto fornito DateTimeOffset in un oggetto 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

Parametri

value
DateTimeOffset

Oggetto DateTimeOffset da convertire.

Valori restituiti

Rappresentazione String dell'oggetto DateTimeOffsetfornito.

Esempio

Nell'esempio seguente viene convertita una DateTimeOffset rappresentazione dell'ora corrente in un oggetto 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

Si applica a

ToString(DateTime)

Attenzione

Use XmlConvert.ToString() that takes in XmlDateTimeSerializationMode

Converte l'oggetto in DateTime un oggetto String.

public:
 static System::String ^ ToString(DateTime value);
public static string ToString(DateTime value);
[System.Obsolete("Use XmlConvert.ToString() that takes in XmlDateTimeSerializationMode")]
public static string ToString(DateTime value);
static member ToString : DateTime -> string
[<System.Obsolete("Use XmlConvert.ToString() that takes in XmlDateTimeSerializationMode")>]
static member ToString : DateTime -> string
Public Shared Function ToString (value As DateTime) As String

Parametri

value
DateTime

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto DateTime nel formato aaaaa-MM-ggTHH:mm:ss dove 'T' è un valore letterale costante.

Attributi

Commenti

Note

Il metodo è obsoleto nella versione 2.0 di .NET Framework ed è stato sostituito con il metodo /> RoundtripKind. Se è prevista una corrispondenza esatta, usare XmlConvert.ToString(DateTime, String) con la stringa yyyy-MM-ddTHH:mm:ss.fffffffzzzzzzdi formato .

Si applica a

ToString(Char)

Converte l'oggetto in Char un oggetto 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

Parametri

value
Char

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Char.

Si applica a

ToString(Byte)

Converte l'oggetto in Byte un oggetto 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

Parametri

value
Byte

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Byte.

Si applica a

ToString(Int32)

Converte l'oggetto in Int32 un oggetto 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

Parametri

value
Int32

Valore da convertire.

Valori restituiti

Rappresentazione di stringa dell'oggetto Int32.

Si applica a