LiteralMode 列挙型

定義

Literal コントロールの内容を表示する方法を指定します。Specifies how the content in a Literal control is rendered.

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

フィールド

Encode 2

リテラル コントロールの内容は HTML エンコードされます。The literal control's contents are HTML-encoded.

PassThrough 1

リテラル コントロールの内容は変更されません。The literal control's contents are not modified.

Transform 0

リテラル コントロールのサポートされないマークアップ言語要素は削除されます。The literal control's unsupported markup-language elements are removed. リテラル コントロールが HTML または XHTML をサポートするブラウザーに表示される場合は、コントロールの内容は変更されません。If the literal control is rendered on a browser that supports HTML or XHTML, the control's contents are not modified.

次の例は、プロパティを設定する方法を示して Literal.Mode います。The following example demonstrates how to set the Literal.Mode property. このコントロールの宣言構文では、最初はに設定され Encode ます。It is initially set to Encode in the declarative syntax for the control. ページが読み込まれた後、ユーザーはボタンをクリックしてプロパティをに設定でき Mode PassThrough ます。After the page loads, the user can click a button to set the Mode property to PassThrough. これにより、プロパティの内容が Literal.Text 異なる方法で表示されます。This causes the contents of the Literal.Text property to render differently.

<%@ 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 ます。The LiteralMode enumeration represents the modes that you can specify for how the content in a Literal control is rendered. プロパティは、 Literal.Mode これらの列挙値を使用して、プロパティの内容の動作を設定し Literal.Text ます。The Literal.Mode property uses these enumeration values to set the behavior of the contents of the Literal.Text property.

を指定すると PassThrough 、プロパティの内容全体が、 Literal.Text 変更なしでデバイスまたはブラウザーに渡されます。If you specify PassThrough, the entire contents of the Literal.Text property are passed to the device or browser without any modifications. たとえば、プロパティにタグが含まれている場合、サポートされている Literal.Text <hr> かどうかに関係なく、すべてのデバイスとブラウザーに送信されます。For example, if the Literal.Text property contains an <hr> tag, it is sent to all devices and browsers regardless of whether it is supported.

を指定した場合、 Encode プロパティの内容は、 Text 表示前に HTML エンコードされた文字列に変換されます。If you specify Encode, the contents for the Text property are converted into an HTML-encoded string before rendering. たとえば、 Literal.Text プロパティにタグが含まれている場合、 <hr> そのタグはに変換され、 &lt;hr&gt; デバイスまたはブラウザーに送信されます。For example, if the Literal.Text property contains an <hr> tag, it will be converted to &lt;hr&gt; and sent to the device or browser.

を指定した場合、 Transform プロパティのレンダリング動作は、 Literal.Text 表示されているマークアップの種類によって異なります。If you specify Transform, the rendering behavior of the Literal.Text property depends on the type of markup being rendered. LiteralHTML または XHTML をサポートするデバイスまたはブラウザーに対してコントロールがレンダリングされると、を指定した場合 Transform と同じ動作が生成され PassThrough ます。When the Literal control is rendered for a device or browser that supports HTML or XHTML, specifying Transform produces the same behavior as specifying PassThrough. 要求元のブラウザーでは、プロパティのすべてのマークアップタグと要素 Literal.Text がレンダリングされます。All markup tags and elements for the Literal.Text property are rendered for the requesting browser.

LiteralHTML または XHTML 以外のマークアップ言語 (WML や cHTML など) に対してコントロールをレンダリングする場合は、値を使用して、 Transform サポートされていないマークアップ要素を削除できます。When the Literal control is rendered for a markup language other than HTML or XHTML, such as WML or cHTML, you can use the Transform value to remove unsupported markup elements. この場合、 Literal.Text 対象のマークアップ言語でサポートされていないプロパティのマークアップ言語要素は、コントロールに対してレンダリングされません。In this case, any markup-language elements of the Literal.Text property that are not supported in the targeted markup language are not rendered for the control. たとえば、 Literal.Text プロパティにタグが含まれている場合、 <hr> コンテンツが WML デバイスに送信される前にタグが削除されます。For example, if the Literal.Text property contains an <hr> tag, the tag is removed before the content is sent to a WML device. サポートされていないタグにコンテンツが含まれている場合、タグだけが削除され、コンテンツはデバイスまたはブラウザーに送信されます。If an unsupported tag contains content, only the tag is removed and the content is sent to the device or browser. たとえば、 Literal.Text プロパティにコンテンツが含まれている場合、 <XYZ>Test</XYZ> <XYZ> </XYZ> テキスト Test がデバイスまたはブラウザーに送信される間、タグとタグは削除されます。For example, if the Literal.Text property contains the content <XYZ>Test</XYZ>, the <XYZ> and </XYZ> tags are removed while the text Test is sent to the device or browser.

適用対象

こちらもご覧ください