Hilfsmethoden für T4-Textvorlagen

Mehrere Methoden stehen Ihnen beim Schreiben von Code in einer Visual Studio-Textvorlage immer zur Verfügung. Diese Methoden sind in TextTransformation definiert.

Write-Methoden

Die Write()- und WriteLine()-Methoden können anstelle eines Ausdruckscodeblocks verwendet werden, um Text in einem Standardcodeblock anzufügen. Die folgenden zwei Codeblöcke sind funktional äquivalent.

Codeblock mit einem Ausdrucksblock

<#
int i = 10;
while (i-- > 0)
    { #>
        <#= i #>
    <# }
#>

Codeblock mit WriteLine()

<# 
    int i = 10;
    while (i-- > 0)
    { 
        WriteLine((i.ToString()));
    }
#>

In einem langen Codeblock mit geschachtelten Kontrollstrukturen kann es hilfreich, eine dieser Hilfsprogrammmethoden anstelle eines Ausdrucksblocks zu verwenden.

Die Write()- und WriteLine()-Methoden verfügen über zwei Überladungen: eine, die einen einzelnen Zeichenfolgenparameter akzeptiert, und eine, die eine zusammengesetzte Formatzeichenfolge sowie ein in die Zeichenfolge einzuschließendes Objektarray akzeptiert (wie die Console.WriteLine()-Methode). Die folgenden zwei Deklarationen von WriteLine() sind funktional äquivalent:

<#
    string msg = "Say: {0}, {1}, {2}";
    string s1 = "hello";
    string s2 = "goodbye";
    string s3 = "farewell";
    
    WriteLine(msg, s1, s2, s3);
    WriteLine("Say: hello, goodbye, farewell");
#> 

Einzugsmethoden

Sie können die Ausgabe der Textvorlage mithilfe von Einzugsmethoden formatieren. Die TextTransformation-Klasse verfügt über eine CurrentIndent-Zeichenfolgeneigenschaft, die den aktuellen Einzug in der Textvorlage anzeigt, und ein indentLengths-Feld, das eine Liste der hinzugefügten Einzüge enthält. Sie können einen Einzug mit der PushIndent() -Methode hinzufügen und mit der PopIndent()-Methode entfernen. Wenn Sie alle Einzüge entfernen möchten, verwenden Sie die ClearIndent()-Methode. Im folgenden Codeblock wird die Verwendung dieser Methoden veranschaulicht:

<#
    WriteLine(CurrentIndent + "Hello");
    PushIndent("    ");
    WriteLine(CurrentIndent + "Hello");
    PushIndent("    ");
    WriteLine(CurrentIndent + "Hello");
    ClearIndent();
    WriteLine(CurrentIndent + "Hello");
    PushIndent("    ");
    WriteLine(CurrentIndent + "Hello");
#>

Dieser Codeblock erzeugt die folgende Ausgabe:

Hello
        Hello
                Hello
Hello
        Hello

Error- und Warning-Methoden

Sie können der Visual Studio-Fehlerliste mithilfe von Error- und Warning-Hilfsmethoden Meldungen hinzufügen. Durch den folgenden Code wird der Fehlerliste z. B. eine Fehlermeldung hinzugefügt.

<#
  try
  {
    string str = null;
    Write(str.Length.ToString());
  }
  catch (Exception e)
  {
    Error(e.Message);
  }
#>  

Zugrifft auf den Host und Dienstanbieter

Die this.Host-Eigenschaft kann Zugriff auf Eigenschaften bieten, die von dem zum Ausführen der Vorlage verwendeten Host verfügbar gemacht werden. Zur Verwendung von this.Host müssen Sie das hostspecific-Attribut in der <@template#>-Direktive festlegen:

<#@template ... hostspecific="true" #>

Der Typ von this.Host hängt vom Typ des Hosts ab, von dem die Vorlage ausgeführt wird. In einer Vorlage, die in Visual Studio ausgeführt wird, können Sie this.Host in IServiceProvider umwandeln, um Zugriff auf Dienste wie IDE zu erhalten. Beispiel:

EnvDTE.DTE dte = (EnvDTE.DTE) ((IServiceProvider) this.Host)
                       .GetService(typeof(EnvDTE.DTE));

Verwenden eines anderen Hilfsmethodensatzes

Im Rahmen des Textgenerierungsprozesses wird die Vorlagendatei in eine Klasse transformiert, die immer den Namen GeneratedTextTransformation erhält und von TextTransformation erbt. Wenn Sie stattdessen einen anderen Satz von Methoden verwenden möchten, können Sie eine eigene Klasse schreiben und in der Vorlagendirektive angeben. Die Klasse muss von TextTransformation erben.

<#@ template inherits="MyUtilityClass" #>

Verwenden Sie die assembly-Direktive, um auf die Assembly zu verweisen, in der sich die kompilierte Klasse befindet.