Bagikan melalui

LiteralMode Enum

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Menentukan bagaimana konten dalam Literal kontrol dirender.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Warisan
Object
ValueType
Enum
LiteralMode

Bidang

Encode 2

Konten kontrol harfiah dikodekan HTML.
PassThrough 1

Konten kontrol harfiah tidak dimodifikasi.
Transform 0

Elemen bahasa markup kontrol harfiah yang tidak didukung dihapus. Jika kontrol harfiah dirender pada browser yang mendukung HTML atau XHTML, konten kontrol tidak dimodifikasi.

Contoh

Contoh berikut menunjukkan cara mengatur Literal.Mode properti . Awalnya diatur ke Encode dalam sintaks deklaratif untuk kontrol. Setelah halaman dimuat, pengguna dapat mengklik tombol untuk mengatur properti ke ModePassThrough. Hal ini menyebabkan konten properti dirender Literal.Text secara berbeda.

<%@ 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>

Keterangan

Enumerasi LiteralMode mewakili mode yang dapat Anda tentukan tentang bagaimana konten dalam kontrol dirender Literal . Properti Literal.Mode menggunakan nilai enumerasi ini untuk mengatur perilaku konten Literal.Text properti.

Jika Anda menentukan PassThrough, seluruh konten Literal.Text properti diteruskan ke perangkat atau browser tanpa modifikasi apa pun. Misalnya, jika Literal.Text properti berisi <hr> tag, properti dikirim ke semua perangkat dan browser terlepas dari apakah itu didukung.

Jika Anda menentukan Encode, konten untuk Text properti dikonversi menjadi string yang dikodekan HTML sebelum penyajian. Misalnya, jika Literal.Text properti berisi <hr> tag, properti akan dikonversi ke &lt;hr&gt; dan dikirim ke perangkat atau browser.

Jika Anda menentukan Transform, perilaku penyajian Literal.Text properti bergantung pada jenis markup yang dirender. Literal Ketika kontrol dirender untuk perangkat atau browser yang mendukung HTML atau XHTML, menentukan Transform menghasilkan perilaku yang sama seperti menentukan PassThrough. Semua tag markup dan elemen untuk Literal.Text properti dirender untuk browser yang meminta.

Literal Saat kontrol dirender untuk bahasa markup selain HTML atau XHTML, seperti WML atau cHTML, Anda dapat menggunakan Transform nilai untuk menghapus elemen markup yang tidak didukung. Dalam hal ini, elemen bahasa markup apa pun dari Literal.Text properti yang tidak didukung dalam bahasa markup yang ditargetkan tidak dirender untuk kontrol. Misalnya, jika Literal.Text properti berisi <hr> tag, tag dihapus sebelum konten dikirim ke perangkat WML. Jika tag yang tidak didukung berisi konten, hanya tag yang dihapus dan konten dikirim ke perangkat atau browser. Misalnya, jika Literal.Text properti berisi konten <XYZ>Test</XYZ>, <XYZ> tag dan </XYZ> dihapus saat teks Test dikirim ke perangkat atau browser.

Berlaku untuk

Lihat juga