XmlConvert.ToString Método

Definición

Espacio de nombres:: System.Xml

Ensamblados:: System.Xml.dll, System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Convierte datos fuertemente tipados en una representación equivalente String .

Sobrecargas

Nombre	Description
ToString(Single)	Convierte en Single .String
ToString(TimeSpan)	Convierte en TimeSpan .String
ToString(UInt16)	Convierte en UInt16 .String
ToString(UInt32)	Convierte en UInt32 .String
ToString(DateTimeOffset, String)	Convierte el proporcionado DateTimeOffset en un String objeto en el formato especificado.
ToString(DateTime, String)	Convierte en DateTime .String
ToString(DateTime, XmlDateTimeSerializationMode)	Convierte en DateTime un String objeto mediante el XmlDateTimeSerializationMode especificado.
ToString(SByte)	Convierte en SByte .String
ToString(UInt64)	Convierte en UInt64 .String
ToString(Int64)	Convierte en Int64 .String
ToString(Boolean)	Convierte en Boolean .String
ToString(Int16)	Convierte en Int16 .String
ToString(Guid)	Convierte en Guid .String
ToString(Double)	Convierte en Double .String
ToString(Decimal)	Convierte en Decimal .String
ToString(DateTimeOffset)	Convierte el proporcionado DateTimeOffset en .String
ToString(DateTime)	Obsoletos. Convierte en DateTime .String
ToString(Char)	Convierte en Char .String
ToString(Byte)	Convierte en Byte .String
ToString(Int32)	Convierte en Int32 .String

ToString(Single)

Convierte en 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

Parámetros

value: Single

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Single.

Comentarios

Si value es Single.PositiveInfinity o Single.NegativeInfinity, este método devuelve la cadena INF o -INF respectivamente.

Consulte también

Se aplica a

ToString(TimeSpan)

Convierte en 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

Parámetros

value: TimeSpan

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de TimeSpan.

Se aplica a

ToString(UInt16)

Importante

Esta API no es conforme a CLS.

Convierte en 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

Parámetros

value: UInt16

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de UInt16.

Atributos: CLSCompliantAttribute

Se aplica a

ToString(UInt32)

Importante

Esta API no es conforme a CLS.

Convierte en 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

Parámetros

value: UInt32

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de UInt32.

Atributos: CLSCompliantAttribute

Se aplica a

ToString(DateTimeOffset, String)

Convierte el proporcionado DateTimeOffset en un String objeto en el formato especificado.

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

Parámetros

value: DateTimeOffset

que DateTimeOffset se va a convertir.

format: String

Formato al que value se convierte. El parámetro format puede ser cualquier subconjunto de la recomendación W3C para el tipo dateTime XML. (Para obtener más información, vea la sección dateTime de la especificación del esquema XML).

Devoluciones

String

Representación String en el formato especificado del proporcionado DateTimeOffset.

Ejemplos

En el ejemplo siguiente se convierte una DateTimeOffset representación de la hora actual en un String en el formato especificado.

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

Se aplica a

ToString(DateTime, String)

Convierte en 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

Parámetros

value: DateTime

Valor que se va a convertir.

format: String

Estructura de formato que define cómo mostrar la cadena convertida. Los formatos válidos incluyen "aaaa-MM-ddTHH:mm:sszzzzzz" y sus subconjuntos.

Devoluciones

String

Representación de cadena de DateTime en el formato especificado.

Ejemplos

En el ejemplo siguiente, se convierten los tipos de datos en una cadena y, a continuación, se escribe la información en la consola.

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

Se aplica a

ToString(DateTime, XmlDateTimeSerializationMode)

Convierte en DateTime un String objeto mediante el XmlDateTimeSerializationMode especificado.

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

Parámetros

value: DateTime

Valor DateTime que se va a convertir.

dateTimeOption: XmlDateTimeSerializationMode

Uno de los XmlDateTimeSerializationMode valores que especifican cómo tratar el DateTime valor.

Devoluciones

String

Equivalente String de .DateTime

Excepciones

ArgumentException

El dateTimeOption valor no es válido.

ArgumentNullException

El value valor o dateTimeOption es null.

Se aplica a

ToString(SByte)

Importante

Esta API no es conforme a CLS.

Convierte en 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

Parámetros

value: SByte

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de SByte.

Atributos: CLSCompliantAttribute

Se aplica a

ToString(UInt64)

Importante

Esta API no es conforme a CLS.

Convierte en 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

Parámetros

value: UInt64

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de UInt64.

Atributos: CLSCompliantAttribute

Se aplica a

ToString(Int64)

Convierte en 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

Parámetros

value: Int64

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Int64.

Se aplica a

ToString(Boolean)

Convierte en 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

Parámetros

value: Boolean

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Boolean, es decir, "true" o "false".

Se aplica a

ToString(Int16)

Convierte en 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

Parámetros

value: Int16

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Int16.

Ejemplos

En el ejemplo siguiente, se convierten los tipos de datos en una cadena y, a continuación, se escribe la información en la consola.

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

Se aplica a

ToString(Guid)

Convierte en 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

Parámetros

value: Guid

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Guid.

Se aplica a

ToString(Double)

Convierte en 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

Parámetros

value: Double

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Double.

Ejemplos

En el ejemplo siguiente, se convierten los tipos de datos en una cadena y, a continuación, se escribe la información en la consola.

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

Comentarios

Si value es Double.PositiveInfinity o Double.NegativeInfinity, este método devuelve la cadena INF o -INF respectivamente.

Consulte también

Se aplica a

ToString(Decimal)

Convierte en 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

Parámetros

value: Decimal

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Decimal.

Se aplica a

ToString(DateTimeOffset)

Convierte el proporcionado DateTimeOffset en .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

Parámetros

value: DateTimeOffset

que DateTimeOffset se va a convertir.

Devoluciones

String

Representación String de la clase proporcionada DateTimeOffset.

Ejemplos

En el ejemplo siguiente se convierte una DateTimeOffset representación de la hora actual en .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

Se aplica a

ToString(DateTime)

Precaución

Use XmlConvert.ToString() that takes in XmlDateTimeSerializationMode

Convierte en DateTime .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

Parámetros

value: DateTime

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de DateTime en el formato aaaa-MM-ddTHH:mm:ss donde 'T' es un literal constante.

Atributos: ObsoleteAttribute

Comentarios

Note

El método XmlConvert.ToString(DateTime) está obsoleto en la versión 2.0 de .NET Framework y se ha reemplazado por el método XmlConvert.ToString(DateTime, XmlDateTimeSerializationMode). El modo sugerido es RoundtripKind. Si se espera una coincidencia exacta, use XmlConvert.ToString(DateTime, String) con la cadena yyyy-MM-ddTHH:mm:ss.fffffffzzzzzzde formato .

Se aplica a

ToString(Char)

Convierte en 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

Parámetros

value: Char

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Char.

Se aplica a

ToString(Byte)

Convierte en 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

Parámetros

value: Byte

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Byte.

Se aplica a

ToString(Int32)

Convierte en 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

Parámetros

value: Int32

Valor que se va a convertir.

Devoluciones

String

Representación de cadena de Int32.

Se aplica a

Comentarios

¿Le ha resultado útil esta página?