LiteralMode 列挙型

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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> 場合は、に <hr> 変換され、デバイスまたはブラウザーに送信されます。

を指定 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がデバイスまたはブラウザーに送信されるときに削除されます。

適用対象

次の方法で共有

LiteralMode 列挙型

定義

フィールド

例

注釈

適用対象

こちらもご覧ください

その他のリソース