Metoda TextTransformation.Write — (String, array<Object )

Artykuł
10/27/2012

Dołącza sformatowany ciąg, który zawiera zero lub więcej specyfikacji formatu, w wyniku tekst wygenerowany.Każda specyfikacja formatu zastępuje reprezentację ciągu odpowiadającego mu argumentu obiektu.

Przestrzeń nazw: Microsoft.VisualStudio.TextTemplating
Zestaw: Microsoft.VisualStudio.TextTemplating.11.0 (w Microsoft.VisualStudio.TextTemplating.11.0.dll)

Składnia

'Deklaracja
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: System.String
Ciąg, który zawiera zero lub więcej specyfikacji formatu.

args
Typ: array<System.Object[]
Tablica obiektów do sformatowania.

Wyjątki

Wyjątek	Warunek
ArgumentNullException	formatis nullodwołanie o wartości null (Nothing w języku Visual Basic). - lub - argsis nullodwołanie o wartości null (Nothing w języku Visual Basic).
FormatException	formatjest nieprawidłowy.
ArgumentOutOfRangeException	Powiększanie wartości instrumentu bazowego StringBuilder przekroczyłaby MaxCapacity.

ArgumentNullException

formatis nullodwołanie o wartości null (Nothing w języku Visual Basic).

- lub -

argsis nullodwołanie o wartości null (Nothing w języku Visual Basic).

FormatException

formatjest nieprawidłowy.

ArgumentOutOfRangeException

Powiększanie wartości instrumentu bazowego StringBuilder przekroczyłaby MaxCapacity.

Uwagi

Write Metoda może być używana bezpośrednio w szablonie tekstu.

Przykłady

Poniższy przykład kodu pokazuje wywołania Write metody z szablonu tekstu.Wklej ten kod do dowolnego pliku tekstowego, szablon, a następnie uruchom transformacji tekst szablonu, aby zobaczyć wyniki.

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

Ten przykład generuje następujące wyniki:

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.

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..