Cambiar biblioteca

MSDN Library

El tema que ha solicitado se muestra abajo. Sin embargo, este tema no se encuentra en la biblioteca.

Este tema aún no ha recibido ninguna valoración - Valorar este tema

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

.NET Framework 4.5

Otras versiones

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[]) .

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

Sintaxis

C++

public virtual void Write(
	string format,
	params Object[] arg
)

Parámetros

format: Tipo: System.String
Una cadena de formato compuesto (vea Comentarios).

arg: Tipo: System.Object[]
Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato y escribir.

Excepciones

Excepción	Condición
ArgumentNullException	El valor de format o arg es null.
ObjectDisposedException	El objeto TextWriter está cerrado.
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 la longitud de la matriz arg.

Comentarios

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:

Para obtener más información sobre la característica de formato compuesto, vea Formatos compuestos.
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas con formato numérico estándar y Cadenas con formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea Cadenas con formato de fecha y hora estándar y Cadenas de formato de fecha y hora personalizadas.
Para obtener más información sobre los especificadores de formato de enumeración, vea Cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Aplicar formato a tipos.

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. Dado que esta sobrecarga tiene una matriz en su lista de parámetros, el valor índice siempre debe ser menor que la longitud de la matriz. 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.

Información de versión

.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

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Plataformas

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.

Vea también