Bagikan melalui

Literal.Mode Properti

Definisi

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

Mendapatkan atau mengatur nilai enumerasi yang menentukan bagaimana konten dalam Literal kontrol dirender.

public:
 property System::Web::UI::WebControls::LiteralMode Mode { System::Web::UI::WebControls::LiteralMode get(); void set(System::Web::UI::WebControls::LiteralMode value); };
public System.Web.UI.WebControls.LiteralMode Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.LiteralMode with get, set
Public Property Mode As LiteralMode

Nilai Properti

LiteralMode

Salah LiteralMode satu nilai enumerasi. Defaultnya adalah Transform.

Pengecualian

ArgumentOutOfRangeException

Jenis yang ditentukan bukan salah LiteralMode satu nilai enumerasi.

Contoh

Contoh kode berikut menunjukkan cara mengatur Literal properti kontrol Mode . Properti Mode 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 Text secara berbeda.

Nota

Contoh berikut menggunakan model kode file tunggal dan mungkin tidak berfungsi dengan benar jika disalin langsung ke file code-behind. Contoh kode ini harus disalin ke dalam file teks kosong yang memiliki ekstensi .aspx. Untuk informasi selengkapnya tentang model kode Formulir Web, lihat Model Kode Halaman Formulir Web ASP.NET.

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

Mode Gunakan properti untuk menentukan bagaimana konten Literal kontrol harus dirender. Properti ini diatur menggunakan salah LiteralMode satu nilai enumerasi. Tabel berikut ini mencantumkan nilai yang mungkin.

Nilai Deskripsi
PassThrough Isi kontrol tidak dimodifikasi.
Encode Konten kontrol dikonversi ke string yang dikodekan HTML.
Transform Elemen bahasa markup yang tidak didukung dihapus dari konten kontrol. Literal Jika kontrol dirender pada browser yang mendukung HTML atau XHTML, konten kontrol tidak dimodifikasi.

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

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

Jika Anda menentukan Transform, perilaku penyajian 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 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 Text properti yang tidak didukung dalam bahasa markup yang ditargetkan tidak dirender untuk kontrol. Misalnya, jika Text properti Literal kontrol 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 Text properti berisi konten <XYZ>Test</XYZ>, <XYZ> tag dan </XYZ> dihapus, dan teks "Uji" dikirim ke perangkat atau browser.

Berlaku untuk

Lihat juga