次の方法で共有


LiteralMode 列挙型

定義

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

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

フィールド

Encode 2

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

PassThrough 1

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

Transform 0

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

次の例では、 プロパティを設定する方法を Literal.Mode 示します。 コントロールの宣言構文では、最初は に Encode 設定されます。 ページが読み込まれたら、ユーザーはボタンをクリックして プロパティを ModePassThrough設定できます。 これにより、 プロパティの内容が 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 レンダリング動作は、レンダリングされるマークアップの種類によって異なります。 コントロールが Literal HTML または XHTML をサポートするデバイスまたはブラウザーに対してレンダリングされる場合、 を指定すると、 を Transform 指定した場合と同じ動作が PassThrough生成されます。 プロパティのすべてのマークアップ タグと要素 Literal.Text は、要求側のブラウザーに対してレンダリングされます。

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

適用対象

こちらもご覧ください