LiteralMode LiteralMode LiteralMode LiteralMode Enum

定義

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

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

フィールド

Encode Encode Encode Encode 2

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

PassThrough PassThrough PassThrough PassThrough 1

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

Transform Transform Transform 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.

次のコード例は、設定する方法を示します、TextコントロールのModeプロパティ。The following code example demonstrates how to set a Text control's Mode property. Modeプロパティ最初にEncodeコントロールの宣言構文内で。The Mode property 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. これが原因の内容、Textプロパティを異なる方法で表示します。This causes the contents of the 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. Modeプロパティでは、これらの列挙値を使用して、設定の内容の動作をTextプロパティ、Literalコントロール。The Mode property uses these enumeration values to set the behavior of the contents of the Text property in a Literal control.

指定した場合PassThroughのすべての内容、Textプロパティは、デバイスまたはブラウザーを変更せずに渡されます。If you specify PassThrough, the entire contents of the Text property are passed to the device or browser without any modifications. たとえば場合、TextのプロパティをLiteralコントロールが含まれています、<hr>タグ、すべてのデバイスとはサポートされているかどうかに関係なくブラウザーに送信されます。For example, if the Text property of a Literal control 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. たとえば場合、TextのプロパティをLiteralコントロールが含まれています、<hr>タグ、それに変換されます&lt;hr&gt;デバイスまたはブラウザーに送信し、。For example, if the Text property of a Literal control contains an <hr> tag, it will be converted to &lt;hr&gt; and sent to the device or browser.

指定した場合Transformのレンダリング動作、Textプロパティは、レンダリングされるマークアップの種類によって異なります。If you specify Transform, the rendering behavior of the Text property depends on the type of markup being rendered. ときに、Literalデバイスのコントロールが表示されるか、HTML または XHTML、変換を指定することをサポートするブラウザーにパススルーを指定すると同じ動作が生成されます。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. すべてのマークアップ タグと要素のTextプロパティが要求側のブラウザーにレンダリングされます。All markup tags and elements for the Text property are rendered for the requesting browser.

ときに、PassThroughコントロールがレンダリングされる HTML または XHTML、cHTML、WML など以外のマークアップ言語、変換の値を使用して、サポートされていないマークアップ要素を削除することができます。When the PassThrough 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. ここでのすべてのマークアップ言語要素、Text対象となるマークアップ言語でサポートされていないプロパティは、コントロールのレンダリングされません。In this case, any markup-language elements of the Text property that are not supported in the targeted markup language are not rendered for the control. などの場合、TextのプロパティをTransformコントロールが含まれています、<hr>コンテンツが、WML デバイスに送信される前に、タグ、タグが削除されました。For example, if the Text property of a Transform control 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. たとえば場合、Textプロパティには、コンテンツが含まれています<XYZ>Test</XYZ><XYZ></XYZ>テキスト中にタグが削除されるTestデバイスまたはブラウザーに送信されます。For example, if the 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.

適用対象

こちらもご覧ください