Metodo TextTransformation.WriteLine (String, array<Object )

Articolo
08/11/2011

Consente di accodare una stringa formattata che contiene zero o più specifiche di formato e il terminatore di riga predefinito all'output di testo generato. Ciascuna specifica di formato viene sostituita dalla rappresentazione di stringa di un argomento oggetto corrispondente.

Spazio dei nomi: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.10.0 (in Microsoft.VisualStudio.TextTemplating.10.0.dll)

Sintassi

'Dichiarazione
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[]
)

Parametri

format
Tipo: System.String
Stringa che contiene zero o più specifiche di formato.

args
Tipo: array<System.Object[]
Matrice di oggetti da formattare.

Eccezioni

Eccezione	Condizione
ArgumentNullException	format è nullriferimento null (Nothing in Visual Basic). In alternativa args è nullriferimento null (Nothing in Visual Basic).
FormatException	format non valido.
ArgumentOutOfRangeException	L'aumento del valore dell'oggetto StringBuilder sottostante supererebbe la proprietà MaxCapacity.

ArgumentNullException

format è nullriferimento null (Nothing in Visual Basic).

In alternativa

args è nullriferimento null (Nothing in Visual Basic).

FormatException

format non valido.

ArgumentOutOfRangeException

L'aumento del valore dell'oggetto StringBuilder sottostante supererebbe la proprietà MaxCapacity.

Note

Il metodo WriteLine può essere utilizzato direttamente in un modello di testo.

Esempi

Nell'esempio di codice seguente viene illustrata la chiamata del metodo WriteLine da un modello di testo. Incollare questo codice in qualsiasi file del modello di testo ed eseguire la trasformazione del modello di testo per vedere i risultati.

<#
    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
#>

Questo esempio produce il seguente output:

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.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.