LiteralMode 列挙型

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

Literal コントロールの内容を表示する方法を指定します。

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
継承
Object
ValueType
Enum
LiteralMode

フィールド

Encode 2

リテラル コントロールの内容は HTML エンコードされます。
PassThrough 1

リテラル コントロールの内容は変更されません。
Transform 0

リテラル コントロールのサポートされないマークアップ言語要素は削除されます。 リテラル コントロールが HTML または XHTML をサポートするブラウザーに表示される場合は、コントロールの内容は変更されません。

例

次の例では、 プロパティを設定する方法を Literal.Mode 示します。 最初は、 コントロールの宣言構文で に Encode 設定されます。 ページが読み込まれた後、ユーザーはボタンをクリックして プロパティを Mode に PassThrough設定できます。 これにより、 プロパティの内容が Literal.Text 異なる方法でレンダリングされます。

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal.Mode Property Example</title>
<script runat="Server">
       
        Sub PassThroughButton_Click(ByVal sender As Object, ByVal e As EventArgs)
   
            Literal1.Mode = LiteralMode.PassThrough
            
            Label1.Text = "The contents of the Literal.Text property " + _
                          "passed through to the browser:"
           
        End Sub
     
   </script>
</head>
<body>
    <form id="Form1" runat="server">
        
        <h3>Literal.Mode Property Example</h3>        
                             
        <asp:Label ID="Label1"
            Text="The HTML-encoded contents of the Literal.Text property:"
            runat="server">     
        </asp:Label><br /><br />
        
        <asp:Literal ID="Literal1"
            Mode="Encode"
            Text= "<b>bold</b><br/><i>italic</i><br/>"          
            runat="server">
        </asp:Literal>
       
        <hr />
       
        <asp:Button ID="PassThroughButton"
            Text="Pass Through Mode"
            OnClick="PassThroughButton_Click"
            runat="server">
        </asp:Button>
         
    </form>
</body>
</html>

注釈

列挙体は LiteralMode 、コントロール内のコンテンツのレンダリング方法に指定できるモードを Literal 表します。 プロパティは Literal.Mode 、これらの列挙値を使用して、 プロパティの内容の動作を Literal.Text 設定します。

を指定 PassThroughすると、プロパティの Literal.Text 内容全体が、変更なしでデバイスまたはブラウザーに渡されます。 たとえば、 プロパティに Literal.Text タグが含まれている <hr> 場合、サポートされているかどうかに関係なく、すべてのデバイスとブラウザーに送信されます。

を指定 Encodeした場合、プロパティの Text 内容は、レンダリングの前に HTML エンコード文字列に変換されます。 たとえば、 プロパティにタグが Literal.Text 含まれている <hr> 場合は、 に &lt;hr&gt; 変換され、デバイスまたはブラウザーに送信されます。

を指定 Transformした場合、プロパティの Literal.Text レンダリング動作は、レンダリングされるマークアップの種類によって異なります。 HTML または XHTML をLiteralサポートするデバイスまたはブラウザーに対してコントロールをレンダリングする場合、 を指定すると、 を指定PassThroughしたTransform場合と同じ動作が生成されます。 プロパティのすべてのマークアップ タグと要素 Literal.Text は、要求側のブラウザーに対してレンダリングされます。

コントロールが Literal HTML または XHTML 以外のマークアップ言語 (WML や cHTML など) に対してレンダリングされる場合は、 値を Transform 使用して、サポートされていないマークアップ要素を削除できます。 この場合、対象となるマークアップ言語でサポートされていない プロパティの Literal.Text マークアップ言語要素は、コントロールに対してレンダリングされません。 たとえば、プロパティにタグが Literal.Text 含まれている <hr> 場合、コンテンツが WML デバイスに送信される前にタグが削除されます。 サポートされていないタグにコンテンツが含まれている場合、タグのみが削除され、コンテンツがデバイスまたはブラウザーに送信されます。 たとえば、 プロパティに コンテンツ<XYZ>Test</XYZ><XYZ>がLiteral.Text含まれている場合、 タグと </XYZ> タグは、テキストTestがデバイスまたはブラウザーに送信されている間に削除されます。

適用対象

こちらもご覧ください