Object.ToString Método
Definición
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í.
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 -> stringPublic Overridable Function ToString () As StringDevoluciones
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
ParseTryParseun 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.
