TextTransformation.WriteLine (Método) (String, array<Object )

Artículo
11/02/2012

Anexa una cadena con formato, que contiene cero o más especificaciones de formato, y el terminador de línea predeterminado, 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.11.0 (en Microsoft.VisualStudio.TextTemplating.11.0.dll)

Sintaxis

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

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

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

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

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

Parámetros

format
Tipo: System.String
Cadena que contiene cero o más especificaciones de formato.

args
Tipo: array<System.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 WriteLine se puede utilizar directamente en una plantilla de texto.

Ejemplos

En el ejemplo de código siguiente se muestra la llamada al método WriteLine 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.