TextTransformation.Write-Methode (String, array<Object )

Artikel
07/20/2011

Fügt eine formatierte Zeichenfolge mit 0 (null) oder mehr Formatangaben an die generierte Textausgabe an. Jede Formatangabe wird durch die Zeichenfolgendarstellung eines entsprechenden Objektarguments ersetzt.

Namespace: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.10.0 (in Microsoft.VisualStudio.TextTemplating.10.0.dll)

Syntax

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

Parameter

format
Typ: System.String
Eine Zeichenfolge mit 0 (null) oder mehr Formatangaben.

args
Typ: array<System.Object[]
Ein Array zu formatierender Objekte.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	format hat den Wert nullNULL-Verweis (Nothing in Visual Basic). – oder – args hat den Wert nullNULL-Verweis (Nothing in Visual Basic).
FormatException	format ist ungültig.
ArgumentOutOfRangeException	Wenn derWer des zugrunde liegenden StringBuilder-Elements vergrößert würde, würde MaxCapacity überschritten.

ArgumentNullException

format hat den Wert nullNULL-Verweis (Nothing in Visual Basic).

– oder –

args hat den Wert nullNULL-Verweis (Nothing in Visual Basic).

FormatException

format ist ungültig.

ArgumentOutOfRangeException

Wenn derWer des zugrunde liegenden StringBuilder-Elements vergrößert würde, würde MaxCapacity überschritten.

Hinweise

Die Write-Methode kann direkt in einer Textvorlage verwendet werden.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen der Write-Methode in einer Textvorlage dargestellt. Fügen Sie diesen Code in eine beliebige Textvorlagendatei ein, und führen Sie die Textvorlagentransformation aus, um die Ergebnisse zu sehen.

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

Dieses Beispiel erzeugt folgende Ausgabe:

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.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.