「Razor」を編集中

'''Razor'''（れざー）とは、[[ASP.NET MVC 3]]で追加されたビューエンジン（テンプレートエンジン）である。
ASP.NET MVC 3ではビューエンジンをサードパーティー製も含め簡単に選べるようになったが、とくに指定しない場合は標準でRazorが使用される。
テンプレートファイルの拡張子は「.cshtml」または「.vbhtml」となる。

[[RazorEngine]]というあらゆる文字列をRazor構文で書けるオープンソースのRazor構文パーサーも存在する<ref>http://razorengine.codeplex.com/</ref>。

== Razor構文 ==
Razor構文は基本的に「@」記号で始まる。

@に続く1語句は、コメントや予約語を除き、基本的に[[C Sharp|C#]]のソースコード扱いとなる。

=== コメント ===
コメントは「@* ～ *@」と書く。
[[F Sharp|F#]]のコメント構文「(* ～ *)」に似ている。
顔文字みたい。
<source lang="html5">
@* これはコメントです *@
</source>

=== コード・ブロック ===
「@ {}」と記述するとソースコードを書くためのコードブロックになる。
<source lang="html5">
@ {
    // ここはC#のソースコードです。
    if (hoge == hage) {
        // hogehage
    }
}
</source>

コードブロック中にHTMLタグが出現すると自動的に開始タグでコードブロックが解除され、閉じタグでコードブロックに戻る。
<source lang="html5">
@ {
    // ここはソースコードです
    <p>ここはHTMLです</p>
    // ここはソースコードです
}
</source>

HTMLタグは出力したくない場合のために独自のtextタグが用意されている。
<source lang="html5">
@ {
    <text>ここはテキストです</text>
}
</source>

textタグを打ち込むのが面倒な人のために「@:」という1行用の省略構文も用意されている。
<source lang="html5">
@ {
    @:ここはテキストです
}
</source>

=== 基本構文 ===
==== RenderBody構文 ====
==== RenderPage構文 ====
==== RenderSection構文 ====
=== 変数 ===
テンプレート変数は「@変数名」という形式で先頭に@記号をつけることでHTMLに埋め込むことができる。変数は標準でHTMLエスケープされた状態となっているので、従来のようにいちいちHtml.Encodeメソッドでエスケープしなくてもよくなっており、セキュリティ的にも間違いが起こりにくい作りとなっている。
<source lang="html5">
<p>こんにちは @Name</p>
</source>

変数をHTMLエスケープしたくない場合はHtml.Rawメソッドを用いる。
<source lang="html5">
<p>こんにちは @Html.Raw(Name)</p>
</source>

== 関連項目 ==
* [[ASP.NET MVC 3]]
* [[ASP.NET MVC]]
* [[WebMatrix]]

== 参考文献 ==
<references/>

== 外部リンク ==

{{stub}}