XmlConvert.ToString Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Converte i dati fortemente tipizzato in una rappresentazione equivalente String .
Overload
| Nome | Descrizione |
|---|---|
| ToString(Single) | |
| ToString(TimeSpan) | |
| ToString(UInt16) | |
| ToString(UInt32) | |
| ToString(DateTimeOffset, String) |
Converte l'oggetto fornito DateTimeOffset in un String oggetto nel formato specificato. |
| ToString(DateTime, String) | |
| ToString(DateTime, XmlDateTimeSerializationMode) |
Converte in DateTime un String oggetto utilizzando l'oggetto XmlDateTimeSerializationMode specificato. |
| ToString(SByte) | |
| ToString(UInt64) | |
| ToString(Int64) | |
| ToString(Boolean) | |
| ToString(Int16) | |
| ToString(Guid) | |
| ToString(Double) | |
| ToString(Decimal) | |
| ToString(DateTimeOffset) |
Converte l'oggetto fornito DateTimeOffset in un oggetto String. |
| ToString(DateTime) |
Obsoleti.
|
| ToString(Char) | |
| ToString(Byte) | |
| ToString(Int32) |
ToString(Single)
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)
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.
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.
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)
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
- 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.
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.
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)
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)
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)
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)
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)
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)
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
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 yyyy-MM-ddTHH:mm:ss.fffffffzzzzzzdi formato .
Si applica a
ToString(Char)
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)
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)
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.