フォームマークアップ内のリテラルテキスト

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ASP.NET モバイルコントロールでいうリテラルテキストとは、Form、Panel、または TextView の各モバイルコントロールに直接配置するテキストのことです。たとえば、Form コントロールに直接テキストを配置するには次のようにします。

<mobile:Form>This is literal text.</mobile:Form>

これにより、大量の HTML を ASP.NET モバイル Web ページのフォームにすばやく表示できます。

次の表に示すように、フォームマークアップ内で使用できる書式設定要素の数には制限があります。

要素	説明
<a>	内部テキストをハイパーリンクに変換します。ハイパーリンクテキストには、他の書式設定タグを含めることはできません。
<b>	内部テキストを太字に変換します。
<br>	改行します。
<i>	内部テキストを斜体に変換します。
<p>	新しい段落を開始します。また、終了タグ </p> と一緒に使用した場合は、内部テキストを別の段落に配置します。

その他のタグは実行時に無視されます。設計時にリテラルテキストにサポート外のタグを記述していて、Visual Studio でページを編集すると、予想外の結果が発生することがあります。

リテラルテキストで使用するタグは、出力結果のタグと必ず対応するとは限りません。たとえば、<p> タグが、コントロールアダプタによって <br> タグに変換される場合があります。また、コントロール自体が改行を伴うため、2 つのコントロール間に唯一のリテラルテキストとして存在する改行は無視されます。2 つのコントロール間で強制的に改行するには、本来の改行とは別に、改行をしないスペース ( ) をコントロール間に記述します。

タグを入れ子にする場合は、ハイパーリンクタグ (<a>) の内側では、入れ子になったタグが認識されないことに注意してください。たとえば、<a> タグの内側で <b> タグまたは <i> タグをリテラルテキストとして入れ子にした場合、このリンクは太字または斜体としてレンダリングされません。<a> タグの内側のタグは、いずれもコントロールに反映されません。

リテラルテキストは、コンパイル時に LiteralText コントロールおよび Link コントロールに変換されます。テキストは静的なので、これらのコントロールを指定可能にする目的はありませんが、ページのコントロールツリー内にはそのままとどまります。コントロールツリーは、ページ自体、その子コントロール、さらにその子コントロールなど、ページ上にあるコントロールのツリーです。このため、フォームの子コントロールをプログラムで列挙すると、LiteralText コントロールを明示的にページに追加していない場合でも、このコントロールも列挙されます。

メモ :
フッターテンプレートのコンテンツがページにインラインで表示されないようにするには、フッターテンプレートに <br> を配置します。