TextTransformation.Write (Método) (String, array<Object[])

Artículo
05/17/2015

Anexa una cadena con formato, que contiene cero o más especificaciones de formato, al resultado de texto generado. Cada especificación de formato se reemplaza por la representación en forma de cadena de un argumento de objeto correspondiente.

Espacio de nombres: Microsoft.VisualStudio.TextTemplating
Ensamblado: Microsoft.VisualStudio.TextTemplating.12.0 (en Microsoft.VisualStudio.TextTemplating.12.0.dll)

Sintaxis

'Declaración
Public Sub Write ( _
    format As String, _
    ParamArray args As Object() _
)

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

public:
void Write(
    String^ format, 
    ... array<Object^>^ args
)

member Write : 
        format:string * 
        args:Object[] -> unit

public function Write(
    format : String, 
    ... args : Object[]
)

Parámetros

format
Tipo: String

Cadena que contiene cero o más especificaciones de formato.

args
Tipo: array<Object[]

Matriz de objetos a la que se va a dar formato.

Excepciones

Excepción	Condición
ArgumentNullException	format es nullreferencia null (Nothing en Visual Basic). O bien args es nullreferencia null (Nothing en Visual Basic).
FormatException	format no es válido.
ArgumentOutOfRangeException	Si se aumenta el valor de la instancia StringBuilder subyacente, se superará MaxCapacity.

ArgumentNullException

format es nullreferencia null (Nothing en Visual Basic).

O bien

args es nullreferencia null (Nothing en Visual Basic).

FormatException

format no es válido.

ArgumentOutOfRangeException

Si se aumenta el valor de la instancia StringBuilder subyacente, se superará MaxCapacity.

Comentarios

El método Write se puede utilizar directamente en una plantilla de texto.

Ejemplos

En el ejemplo de código siguiente se muestra la llamada al método Write desde una plantilla de texto. Pegue este código en cualquier archivo de plantilla del texto y ejecute la transformación de plantilla de texto para ver los resultados.

<#
    string message = @"{0}: This is text to append number {1:F}.";

    Write(message, 0, 0);          //Using the Write method
    WriteLine(null);               //Using the WriteLine method
    WriteLine(null);               //Using the WriteLine method
    
    for(int j=1; j<4; j++)
    {
        WriteLine(message, j, j);  //Using the WriteLine method
    }
#>

<#
    Dim message as String = "{0}: This is text to append number {1:F}."
    Dim j as Integer = 0

    Write(message, 0, 0)          'Using the Write method
    WriteLine(Nothing)            'Using the WriteLine method
    WriteLine(Nothing)            'Using the WriteLine method
    
    For j = 1 To 3

        WriteLine(message, j, j)  'Using the WriteLine method
    Next
#>

Este ejemplo produce el siguiente resultado.

0: This is text to append number 0.00.

1: This is text to append number 1.00.

2: This is text to append number 2.00.

3: This is text to append number 3.00.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.