TextTransformation.WriteLine, méthode (String, array<Object )

Article
08/10/2011

Ajoute, à la sortie de texte générée, une chaîne mise en forme qui contient zéro, une ou plusieurs spécifications de format et la marque de fin de ligne par défaut. Chaque spécification de format est remplacée par la représentation sous forme de chaîne d'un argument objet correspondant.

Espace de noms : Microsoft.VisualStudio.TextTemplating
Assembly : Microsoft.VisualStudio.TextTemplating.10.0 (dans Microsoft.VisualStudio.TextTemplating.10.0.dll)

Syntaxe

'Déclaration
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[]
)

Paramètres

format
Type : System.String
Chaîne qui contient zéro, une ou plusieurs spécifications de format.

args
Type : array<System.Object[]
Tableau d'objets à mettre en forme.

Exceptions

Exception	Condition
ArgumentNullException	format est nullune référence null (Nothing en Visual Basic). ou args est nullune référence null (Nothing en Visual Basic).
FormatException	format n'est pas valide.
ArgumentOutOfRangeException	Une augmentation de la valeur du StringBuilder sous-jacent dépasserait MaxCapacity.

ArgumentNullException

format est nullune référence null (Nothing en Visual Basic).

args est nullune référence null (Nothing en Visual Basic).

FormatException

format n'est pas valide.

ArgumentOutOfRangeException

Une augmentation de la valeur du StringBuilder sous-jacent dépasserait MaxCapacity.

Notes

La méthode WriteLine peut être utilisée directement dans un modèle de texte.

Exemples

L'exemple de code suivant montre l'appel de la méthode WriteLine à partir d'un modèle de texte. Collez ce code dans un fichier de modèle de texte et exécutez la transformation du modèle de texte pour consulter les résultats.

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

Cet exemple produit la sortie suivante :

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.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.