TextTransformation.WriteLine Method (String, array<Object )

Appends a formatted string, which contains zero or more format specifications, and the default line terminator, to the generated text output. Each format specification is replaced by the string representation of a corresponding object argument.

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

Syntax

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

Parameters

• format
  Type: System.String

  A string that contains zero or more format specifications.

• args
  Type: array<System.Object[]

  An array of objects to format.

Exceptions

Remarks

The WriteLine method can be used directly in a text template.

Examples

The following code example demonstrates calling the WriteLine method from a text template. Paste this code into any text template file and run the text template transformation to see the results.

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

This example produces the following 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.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

TextTransformation Class

WriteLine Overload

Microsoft.VisualStudio.TextTemplating Namespace

GenerationEnvironment

StringBuilder

AppendFormat

MaxCapacity

ArgumentOutOfRangeException

FormatException

ArgumentNullException

Other Resources

Formatting Types

Numeric Format Strings

Date and Time Format Strings

Enumeration Format Strings

How to: Append to the Generated Text