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 轉譯行為取決於所呈現的標記類型。 Literal當控制項針對支援 HTML 或 XHTML 的裝置或瀏覽器轉譯時，指定 Transform 會產生與指定 PassThrough 相同的行為。 要求瀏覽器會轉譯 屬性的所有標記標記和元素 Literal.Text 。

Literal當控制項針對 HTML 或 XHTML 以外的標記語言轉譯時，例如 WML 或 cHTML，您可以使用 值來移除不支援的 Transform 標記專案。 在此情況下，目標標記語言中不支援之屬性的任何標記語言專案 Literal.Text 都不會針對控制項轉譯。 例如，如果 Literal.Text 屬性包含 <hr> 標記，則會在內容傳送至 WML 裝置之前移除標籤。 如果不支援的標籤包含內容，則只會移除標籤，並將內容傳送至裝置或瀏覽器。 例如，如果 Literal.Text 屬性包含內容 <XYZ>Test</XYZ> ，則會 <XYZ> 在文字 Test 傳送至裝置或瀏覽器時移除 和 </XYZ> 標記。

適用於

另請參閱