テンプレートエンジン
テンプレートを解析し、目的のテキストファイルを生成するプログラムモジュールをテンプレートエンジンと呼びます。
minimal-templateの仕様を満たすテンプレートエンジンはいろいろな言語で作成することができます。ここではC#で作られた.NetFramework用のテンプレートエンジンを提供します。
NetFramework2.0用MinimalTemplateライブラリ
WebサーバーでのダイナミックなWebページ発行のほか、Windowsアプリケーションにも利用できるテンプレートエンジンです。
このテンプレートエンジンはC#で作られたライブラリで.NetFramework2.0で動く言語で使用可能です。このライブラリファイルの名前はMinimalTemplate.dllです、DLLファイルを参照してプロジェクトに追加してください。
MinimalTemplateライブラリには単一のtemplateクラスが含まれています。
NetFramework2.0用MinimalTemplateライブラリのダウンロード
Templateクラス
Templateクラスは１つのコンストラクタと４つのパブリックメソッドをメンバとする簡単なクラスです。パブリックメソッドの１つはユーティリティでですので、通常は３つのメソッドだけでプログラムします。
Templateクラスは内部に変数値テーブルを持ちます。
ClearVariablesメソッドは変数値テーブルをクリアします。
AddVariableメソッドは変数テーブルに変数と変数値のペアを追加します。
Parseメソッドはテンプレートファイルを解析して目的の文章を文字列して取得します。
(例)
Template template = new template();
template.AddVariable("BookName", "テンプレートの使い方");
template.AddVariable("Price", 1200);
template.Parse("Book.mtp", System.Text.Encoding.UTF8);
名前空間
templateクラスはMinimalTemplate名前空間に属します。
コンストラクタ
public template()
templateクラスの新しいインスタンスを初期化します。
内部の変数値テーブルはクリアされます。
ClearVariablesメソッド
public void ClearVariables()
内部の変数値テーブルを初期化します。
AddVariableメソッド
public void AddVariable(string varname, object value)
varname 変数名
value 変数値
内部の変数値テーブルに変数名と変数値のペアを追加します。
変数値はbyte、short、int、float等のdecimalにキャスト可能な数値、またはstring、またはbool型の値です。
Parseメソッド
public string Parse(string fileName, Encoding defaultEncoding)
fileName テンプレートファイル名
defaultEncoding デフォルトの文字コード
テンプレートファイルを解析しテキストを生成します。
テンプレートファイルの文字コードはテンプレートファイルの先頭に文字コードが指定されている場合はそれに従います。
テンプレートファイルの先頭に文字コードが指定されていない場合はdefaultEncodingの指定に従います。
テンプレートファイルの先頭に文字コード指定とはXML宣言やHTML宣言などです。
GetUndefineVariableNameListメソッド
public List GetUndefineVariableNameList(string fileName, Encoding defaultEncoding)
fileName テンプレートファイル名
defaultEncoding デフォルトの文字コード
テンプレートファイルで使われている変数名のうち、変数値テーブルに登録されていないもののリストを取得します。
引数はParseメソッドと同じです。