TextTransformation.WriteLine-Methode (String, array<Object[])
Fügt eine formatierte Zeichenfolge mit 0 (null) oder mehr Formatangaben sowie das Standardzeilenabschlusszeichen an die generierte Textausgabe an. Jede Formatangabe wird durch die Zeichenfolgendarstellung eines entsprechenden Objektarguments ersetzt.
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[]
)
Parameter
format
Typ: StringEine Zeichenfolge mit 0 (null) oder mehr Formatangaben.
args
Typ: array<Object[]Ein Array zu formatierender Objekte.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | format ist nullein Nullverweis (Nothing in Visual Basic). - oder - args ist nullein Nullverweis (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 WriteLine-Methode kann direkt in einer Textvorlage verwendet werden.
Beispiele
Im folgenden Codebeispiel wird das Aufrufen der WriteLine-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 die 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.
Siehe auch
Referenz
Microsoft.VisualStudio.TextTemplating-Namespace
Weitere Ressourcen
Formatieren von Typen in .NET Framework