Literal.Mode Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

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. Default 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 Text properti dirender secara berbeda.

Catatan

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 mencantumkan nilai yang mungkin.

Nilai	Deskripsi
`PassThrough`	Isi kontrol tidak diubah.
`Encode`	Konten kontrol dikonversi ke string yang dikodekan HTML.
`Transform`	Elemen markup-language yang tidak didukung dihapus dari konten kontrol. Literal Jika kontrol dirender di 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, itu Literal dikirim ke semua perangkat dan browser apakah itu 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, itu Literal dikonversi ke <Hr> 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

Bagikan melalui