Write Método (String, Object[])
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

TextWriter.Write (Método) (String, 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[]).

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

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

Parámetros

format
Type: System.String

Cadena de formato compuesto (vea Comentarios).

arg
Type: System.Object[]

Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato y escribir.

Exception Condition
ArgumentNullException

El valor de format o arg es null.

ObjectDisposedException

El TextWriter se cierra.

IOException

Error de E/S.

FormatException

format no es una cadena de formato compuesto válido.

O bien

El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que la longitud de la arg matriz.

Este método utiliza el 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 gran compatibilidad de formato, que se describe con mayor detalle en los temas de formato siguientes:

El format parámetro consta de cero o más ejecuciones de texto combinadas con cero o más marcadores de posición indizados, denominados elementos de formato, que corresponden a un objeto en la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato con la representación de cadena del valor del objeto correspondiente.

La sintaxis de un elemento de formato es como sigue:

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

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

Elemento

Descripción

índice

La posición de base cero en la lista de parámetros de objeto que se va a dar formato. Si el objeto especificado por índice es null, el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene una matriz en su parámetro lista, el valor de índice siempre debe ser menor que la longitud de la matriz. Si no hay ningún parámetro en el índice posición, un FormatException se produce.

,longitud

El número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; Si es negativo, está alineado a la izquierda.

:formatString

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

Las iniciales y finales de caracteres, de llave "{" y "}", son necesarios. Para especificar una única llave literal en format, especifique dos iniciales o finales llaves; es decir, "{{" o "}}".

Este método no buscar la cadena especificada para los caracteres individuales de nueva línea (hexadecimal 0x000a) y reemplácelas 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 de E/S comunes, consulte Tareas de E/S comunes.

Universal Windows Platform
Disponible desde 4.5
.NET Framework
Disponible desde 1.1
Portable Class Library
Compatible con: portable .NET platforms
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar:
© 2016 Microsoft