Proces transformace textu šablony
Proces transformace textu šablony jako vstupní soubor šablony text a generuje nový textový soubor jako výstup.Text šablony můžete použít ke generování kódu jazyka Visual Basic nebo C# nebo můžete generovat zprávu ve formátu HTML.
Tři součásti účastní tohoto procesu: motoru, hostitel a směrnice procesorů.Motor se řídí proces; pracuje s hostitelem a směrnice procesoru vytvořit výstupní soubor.Hostitel obsahuje všechny interakce s prostředím, jako je například umístění souborů a sestavení.Přidá směrnice procesor funkce, například čtení dat ze souboru XML nebo databáze.
Proces transformace textu šablony probíhá ve dvou krocích.Motor nejprve vytvoří dočasnou třídu, která je známá jako třída vygenerované transformace.Tato třída obsahuje kód, který je generován směrnicemi a řídicí bloky.Poté se motor sestaven a proveden třídy vygenerované transformace vytvořit výstupní soubor.
Komponenty
Součást |
Description |
Přizpůsobitelné (Ano/Ne) |
|---|---|---|
Stroj |
Součásti motoru řídí proces transformace textu šablony |
Ne. |
Hostitel |
Hostitel je rozhraní mezi motorem a uživatelského prostředí.Visual Studioje hostitelský proces transformace textu. |
Ano.Můžete napsat vlastní hostitele. |
Směrnice procesorů |
Směrnice procesory jsou třídy, které zpracovávají směrnic v textu šablony.Směrnic můžete použít k poskytnutí dat text šablony z vstupní zdroje. |
Ano.Napsat vlastní směrnice procesorů |
Motor
Motor obdrží šablonu jako řetězec z hostitele, který zpracovává všechny soubory, které jsou použity v procesu transformace.Motor poté požádá hostitele najít žádné vlastní směrnice procesory a další aspekty životního prostředí.Motor pak zkompiluje a spustí třídy vygenerované transformace.Motor vrátí generovaný text na hostitele, který obvykle ukládá do souboru text.
Hostitel
Hostitel je odpovědný za vše, co se týká prostředí mimo proces transformace, včetně následujících:
Vyhledání textu a binárních souborů, které požaduje směrnice procesor nebo motoru.Hostitel Prohledat adresáře a globální mezipaměť sestavení (GAC) vyhledejte sestavení.Hostitele lze najít vlastní procesor směrnice kód motoru.Hostitele lze vyhledat a číst textové soubory a vrátit jejich obsah jako řetězce.
Poskytuje seznam standardních sestav a obory názvů, které motor používaný k vytvoření třídy vygenerované transformace.
Poskytování aplikační doménu, která se používá při motoru zkompiluje a spustí třídy vygenerované transformace.Samostatný aplikační domény se používá k ochraně hostitelské aplikaci z chyb v kódu šablony.
Zápis generované výstupního souboru.
Nastavení výchozí přípona pro soubor generovaný výstup.
Zpracování chyb transformační šablonu text.Hostitele lze zobrazit chyby v uživatelském rozhraní nebo zapsat do souboru.(V Visual Studio, chyby se zobrazí v okně chybové zprávy.)
Pokud uživatel volal směrnice bez zadání hodnoty, poskytování hodnotu Povinný parametr.Směrnice procesoru, můžete zadat název směrnice a parametr a požádejte hostitele zadejte výchozí hodnotu, pokud existuje.
Směrnice a směrnice procesorů
Směrnice je v šabloně text příkazu.Parametry procesu generování poskytuje.Obvykle směrnic definovat zdroj a typ modelu nebo jiné vstupní a výstupní soubor příponu.
Směrnice procesor může zpracovat jeden nebo více směrnic.Když transformujete šablony, musíte mít nainstalovaný směrnice procesor, který lze čelit směrnic v šabloně.
Přidáním kódu do třídy vygenerované transformace se práce směrnic.Směrnic z šablony text a modul zpracovává směrnice volání call vytvoří třídu vygenerované transformace.Po úspěšné volání směrnice zbývající kód, který píšete do textu šablony lze spoléhat na funkce, které poskytuje směrnice.Můžete například vytvořit následující volání import směrnice v šabloně:
<#@ import namespace="System.Text" #>
Standardní směrnice procesoru převede na using prohlášení ve třídě vygenerované transformace.Potom můžete StringBuilder třídy ve zbytku kódu šablony bez opravňující ji jako System.Text.StringBuilder.