Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Object.ToString (Método)

Retorna una cadena que representa al objeto actual.

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

abstract ToString : unit -> string 
override ToString : unit -> string 

Valor devuelto

Tipo: System.String
Cadena que representa el objeto actual.

ToString es el método de formato primario en .NET Framework. Convierte un objeto en su representación de cadena para que sea conveniente para la presentación. (Para obtener más información sobre compatibilidad de formatos en .NET Framework, vea Aplicar formato a tipos.)

La implementación predeterminada del método ToString devuelve el nombre completo del tipo de Object, como se muestra en el ejemplo siguiente.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Dado que Object es la clase base de todos los tipos de referencia en .NET Framework, este comportamiento hereda tipos de referencia que no invalidan el método ToString. Debido a que Object es la clase base de todos los tipos de referencia en .NET Framework, este comportamiento es heredado por los tipos de referencia que no reemplazan el método ToString. Define una clase denominada Object1 que acepta la implementación predeterminada de todos los miembros Object. Su método ToString devuelve el nombre de tipo completo del objeto.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Los tipos invalidan normalmente el método ToString para devolver una cadena que representa la instancia de objeto. Por ejemplo, los tipos base tales como Char, Int32 y String proporcionan implementaciones de ToString que devuelven el formato de cadena del valor que representa el objeto. En el siguiente ejemplo se define una clase, Object2, que invalida el método ToString para devolver el nombre de tipo junto con su valor.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Notas para Windows en tiempo de ejecución

Cuando se llama al método de ToString en una clase de Windows en tiempo de ejecución, proporciona el comportamiento predeterminado para las clases que no reemplazan ToString. Esto forma parte de la compatibilidad que .NET Framework proporciona para Windows en tiempo de ejecución (vea Compatibilidad de .NET Framework con las aplicaciones de la Tienda Windows y Windows en tiempo de ejecución). Las clases de Windows en tiempo de ejecución no heredan Object, y no implementan siempre ToString. Sin embargo, siempre aparecen para tener ToString, Equals(Object), y métodos de GetHashCode cuando se utiliza en código de C# o Visual Basic, y .NET Framework proporciona un comportamiento predeterminado para estos métodos.

A partir de .NET Framework 4.5.1, Common Language Runtime usará IStringable.ToString en un objeto de Windows en tiempo de ejecución antes de recurrir a la implementación predeterminada de Object.ToString.

NotaNota

las clases deWindows en tiempo de ejecución programadas en C# o Visual Basic pueden invalidar el método de ToString .

7bxwbwt2.collapse_all(es-es,VS.110).gifWindows en tiempo de ejecución y la interfaz de IStringable

A partir de Windows 8.1, Windows en tiempo de ejecución incluye IStringable una interfaz cuyo método IStringable.ToString, proporcione la compatibilidad básica de formato comparable al proporcionado por Object.ToString. Para evitar la ambigüedad, no se debe implementar IStringable en tipos administrados.

Cuando los objetos administrados son llamados por código nativo o por el código escrito en lenguajes como JavaScript o C++/CX, aparecen para implementar IStringable. Common Language Runtime automáticamente distribuirá llamadas IStringable.ToString a Object.ToString en el evento IStringable no se implementa en el objeto administrado.

Nota de precauciónPrecaución

Dado que los auto- ayudas de Common IStringable Language Runtime para todas las aplicaciones administradas de Tienda Windows de los tipos de, se recomienda no proporciona dispone IStringable de la implementación. La implementación IStringable puede producir un comportamiento imprevisto al llamar a ToString de Windows en tiempo de ejecución, de C++/CX, o JavaScript.

Si decide implementar IStringable en un tipo administrado público que se exporte en un componente de Windows en tiempo de ejecución , se aplican las restricciones siguientes:

  • Puede definir IStringable la interfaz sólo en una “clase implementa” la relación, por ejemplo

    public class NewClass : IStringable
    

    en C#, o

    Public Class NewClass : Implements IStringable
    

    en Visual Basic.

  • No puede implementar IStringable en una interfaz.

  • No se puede declarar un parámetro como de tipo IStringable.

  • IStringable no puede ser el tipo de valor devuelto de un método, una propiedad, o campo.

  • No puede ocultar IStringable la implementación de clases base utilizando una definición de método como el siguiente:

    
    public class NewClass : IStringable
    {
       public new string ToString()
       {
          return "New ToString in NewClass";
       }
    }
    
    

    En su lugar, IStringable.ToString la implementación debe invalidar siempre la implementación de la clase base. Puede ocultar una implementación de ToString sólo invocandola en una instancia de clase fuertemente tipada.

Observe que en una variedad de condiciones, llamadas a código nativo a un tipo administrado que implemente IStringable o oculta la ToString implementación pueden generar un comportamiento inesperado.

Notas para los herederos

Al implementar sus propios tipos, debería invalidar el método ToString a los valores devueltos que son significativos para esos tipos. Las clases derivadas que requieren más control sobre cómo dar formato que el proporciona ToString pueden implementar la interfaz IFormattable. Su método IFormattable.ToString(String, IFormatProvider) permite definir cadenas de formato que controlan el formato y utilizar un objeto IFormatProvider que puede proporcionar el formato específico de la referencia cultural.

Reemplaza el método de ToString deben seguir estas instrucciones:

  • La cadena devuelta debe ser fácil de usar y legible por los seres humanos.

  • La cadena devuelta debe identificar el valor de la instancia de objeto.

  • La cadena devuelta debe ser lo más corta posible para que sea apropiado para la presentación de un depurador.

  • La invalidación de ToString no debe devolver String.Empty o una cadena nula.

  • La invalidación de ToString no debe producir una excepción.

  • Si la representación de cadena de una instancia es cultura- confidencial o puede ser el formato de varias maneras, implemente la interfaz de IFormattable .

  • Si la cadena devuelta incluye información confidencial, primero debe requerir un permiso adecuado. Si la petición se realiza correctamente, puede devolver información confidencial; si no, debe devolver una cadena que excluye la información confidencial.

  • La invalidación de ToString no debe tener ningún efecto secundario observable para evitar complicaciones en depuración. Por ejemplo, una llamada al método de ToString no debe cambiar el valor de los campos de instancia.

  • Si el tipo implementa un método parse (o Parse o método de TryParse , un constructor, o algún otro método estático que crea una instancia del tipo de una cadena), debe asegurarse de que la cadena devuelta por el método de ToString se puede convertir en una instancia de objeto.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft