Object.ToString Método

Definición

Devuelve una cadena que representa el objeto actual.

public:
 virtual System::String ^ ToString();
public virtual string ToString ();
public virtual string? ToString ();
abstract member ToString : unit -> string
override this.ToString : unit -> string
Public Overridable Function ToString () As String

Devoluciones

Una cadena que representa el objeto actual.

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de api para Object.ToString.

Notas a los desarrolladores de herederos

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

Las invalidaciones del ToString() método deben seguir estas directrices:

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

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

  • La cadena devuelta debe ser lo más corta posible para que un depurador pueda mostrarla.

  • La ToString() invalidación no debe devolver Empty ni una cadena nula.

  • La ToString() invalidación no debería producir una excepción.

  • Si la representación de cadena de una instancia distingue referencias culturales o se puede dar formato de varias maneras, implemente la IFormattable interfaz .

  • Si la cadena devuelta incluye información confidencial, primero debe exigir un permiso adecuado. Si la demanda se realiza correctamente, puede devolver la información confidencial; de lo contrario, debe devolver una cadena que excluya la información confidencial.

  • La ToString() invalidación no debe tener efectos secundarios observables para evitar complicaciones en la depuración. Por ejemplo, una llamada al ToString() método no debe cambiar el valor de los campos de instancia.

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

Se aplica a

Consulte también