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

TextWriter.Write (Método) (String, Object, Object, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object, Object, Object) .

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

public virtual void Write(
	string format,
	Object arg0,
	Object arg1,
	Object arg2
)

Parámetros

format
Tipo: System.String
Cadena de formato compuesto (vea Comentarios).
arg0
Tipo: System.Object
Primer objeto al que se va a dar formato y escribir.
arg1
Tipo: System.Object
Segundo objeto al que se va a dar formato y escribir.
arg2
Tipo: System.Object
Tercer objeto al que se va a dar formato y escribir.

ExcepciónCondición
ArgumentNullException

format es null.

ObjectDisposedException

La clase TextWriter está cerrada.

IOException

Se produce un error de E/S.

FormatException

format no es una cadena de formato compuesta.

O bien

El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga del método, es tres).

Este método utiliza la característica de formato compuesto de .NET Framework para convertir el valor de un objeto en su representación de cadena e incrustar dicha representación en una cadena. .NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los siguientes temas referentes al formato:

El parámetro format consta de ninguna o varias ejecuciones de texto combinadas entre sí con ninguno o varios marcadores de posición indizados, elementos de formato llamados, que se corresponden con un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de cadena del valor del objeto correspondiente.

La sintaxis de un elemento de formato es la siguiente:

{índice[,longitud][:cadenaDeFormato]}

Los elementos entre corchetes son opcionales. En la tabla siguiente se describe cada elemento. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea Formatos compuestos.

Elemento

Descripción

índice

Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es null, el elemento de formato se reemplazará por String.Empty. Como esta sobrecarga tiene tres objetos en su lista de parámetros, el valor de índice siempre debe ser 0, 1, 2. Si no hay ningún parámetro en la posición especificada por índice, se producirá una excepción FormatException.

,longitud

Número mínimo de caracteres de la representación de cadena del parámetro. Si su valor es positivo, el parámetro se alineará a la derecha; si es negativo, se alineará a la izquierda.

:cadenaDeFormato

Una cadena con formato personalizado o estándar que es compatible con el objeto al que se va a dar formato. Los valores posibles de formatString son los mismos que los valores compatibles con el método ToString(format) del objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la interfaz IFormattable, se pasa null como valor del parámetro format que se utiliza como cadena de formato de IFormattable.ToString.

Las llaves inicial y final, "{" y "}", son obligatorias. Para especificar una única llave literal en format, hay que escribir dos llaves iniciales o dos llaves finales, es decir, "{{" o "}}".

Este método no busca la cadena especificada por caracteres de nueva línea individuales (hexadecimal 0x000a) y no los reemplaza con TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.

Para obtener una lista de tareas comunes de E/S, vea Tareas de E/S comunes.

.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

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