Sdílet prostřednictvím

Vytvoření kódu a textové šablony T4

  • Článek

V Visual Studio, T4 text šablony je směs textové bloky a řídicí logiky, který lze generovat textový soubor.Řídicí logiky je zapsán jako fragmenty kódu programu v Visual C# nebo Visual Basic. Generovaný soubor může být text jakéhokoli druhu, například webové stránky nebo souboru prostředků nebo zdrojový kód programu v libovolném jazyce.

Existují dva druhy T4 text šablony:

  • Spustit čas T4 text šablony ("předzpracovány" šablony) jsou spouštěny v aplikaci obvykle jako součást svého výstupu vyrábět textové řetězce.
    Můžete například vytvořit šablony definovat stránku HTML:

    <html><body>
 The date and time now is: <#= DateTime.Now #>
</body></html>

    Šablona se podobá generovaný výstup oznámení.Podobnost šablony pro výsledný výstup umožňuje vyhnout se chyby, pokud chcete změnit.

    Šablona obsahuje navíc fragmenty kódu programu.Tyto fragmenty můžete opakovat úseky textu Podmíněné sekce a zobrazit data z aplikace.

    Chcete-li generovat výstup aplikace volá funkci, která je generována v šabloně.Příklad:

    string webResponseText = new MyTemplate().TransformText();

    Aplikaci lze spustit v počítači, který nemá Visual Studio nainstalován.

    Chcete-li vytvořit šablonu spuštění, přidat Preprocessed text šablony souboru do projektu.Alternativně můžete přidat soubor prostého textu a nastavit jeho Vlastní nástroj vlastnost TextTemplatingFilePreprocessor.

    Další informace naleznete v tématu Generování textu za běhu pomocí textových šablon T4.Další informace o syntaxi šablon naleznete v tématu Tvorba textové šablony T4.

  • Návrhu T4 text šablony jsou provedeny v Visual Studio definovat část zdrojového kódu a další prostředky aplikace.
    Obvykle několik šablon, které číst data v databázi nebo jeden vstupní soubor použít a generovat některé vaše .cs, .vb, nebo další zdrojové soubory.Každá šablona vytvoří jeden soubor.Jsou prováděna v rámci Visual Studio nebo MSBuild.

    Vstupní data může být například soubor XML dat konfigurace.Při každé úpravě souboru XML během vývoje, by obnovit text šablony část kódu aplikace.Jednu ze šablon může vypadat v následujícím příkladu:

    <#@ output extension=".txt" #>
<#@ assembly name="System.Xml" #>
<#
 System.Xml.XmlDocument configurationData = ...; // Read a data file here.
#>
namespace Fabrikam.<#= configurationData.SelectSingleNode("jobName").Value #>
{
  ... // More code here. 
}

    Závislé na hodnoty v souboru XML vytvořené .cs soubor bude vypadat následující:

    namespace Fabrikam.FirstJob
{
  ... // More code here. 
}

    Například může být vstupní diagram pracovního postupu v obchodní činnosti.Po změně pracovního postupu jejich obchodní nebo zahájení práce s novým uživatelům, kteří mají jiný pracovní postup, je snadné znovu generovat kód podle nového modelu.

    Návrh šablony umožňují rychlejší a spolehlivější změnit konfiguraci při změně požadavky.Vstup je obvykle definována z hlediska obchodní požadavky Příklad pracovního postupu.Usnadňuje diskutovat s uživatelům změny.Šablony návrhu jsou proto užitečný nástroj v procesu rozvoje agilní.

    Chcete-li vytvořit šablonu návrhu, přidání Text šablony souboru do projektu.Alternativně můžete přidat soubor prostého textu a nastavit jeho Vlastní nástroj vlastnost TextTemplatingFileGenerator.

    Další informace naleznete v tématu Vytvoření kódu v době návrhu pomocí textových šablon T4.Další informace o syntaxi šablon naleznete v tématu Tvorba textové šablony T4.

[!POZNÁMKA]

Termín modelu se někdy používá k popisu dat načíst jednu nebo více šablon.Model může být v libovolném formátu v libovolném typu souboru nebo databáze.Nemá být modelu UML nebo model domény specifické pro jazyk. 'Model "pouze označuje, že jde o obchodní principy lze definovat data, nikoli připomínající kód.

Funkce transformace textu šablony s názvem T4.

V tomto oddíle

Viz také

Koncepty

Postupy: Generování souborů z modelu UML

Další zdroje

Vytváření kódu z jazyka specifického pro doménu