TextTransformation.Write – metoda (String, array<Object )

Článek
05/16/2015

Připojí výstup generovaný text formátovaný řetězec obsahující nula nebo více specifikací formátu.Řetězcové vyjádření argument objektu nahrazuje každé specifikace formátu.

Obor názvů: Microsoft.VisualStudio.TextTemplating
Sestavení: Microsoft.VisualStudio.TextTemplating.12.0 (v Microsoft.VisualStudio.TextTemplating.12.0.dll)

Syntaxe

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

Parametry

format
Typ: String

Řetězec obsahující nula nebo více specifikací formátu.

args
Typ: array<Object[]

Pole objektů, které mají být formátovány.

Výjimky

Výjimka	Podmínka
ArgumentNullException	format je nullodkaz null (Nothing v jazyce Visual Basic). -nebo- args je nullodkaz null (Nothing v jazyce Visual Basic).
FormatException	format je neplatná.
ArgumentOutOfRangeException	Zvětšení hodnoty základní StringBuilder by překročil MaxCapacity.

ArgumentNullException

format je nullodkaz null (Nothing v jazyce Visual Basic).

-nebo-

args je nullodkaz null (Nothing v jazyce Visual Basic).

FormatException

format je neplatná.

ArgumentOutOfRangeException

Zvětšení hodnoty základní StringBuilder by překročil MaxCapacity.

Poznámky

Write Metoda může být použita přímo v šabloně text.

Příklady

Následující příklad kódu ukazuje volání Write metoda text šablony.Vložte tento kód na libovolný textový soubor šablony a spusťte transformace textu šablony zobrazíte výsledky.

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

Tento příklad vytvoří následující výstup:

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.

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.