LiteralMode Sabit listesi

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimdeki Literal içeriğin nasıl işlendiğini belirtir.

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

Alanlar

Encode 2

Değişmez değer denetiminin içeriği HTML ile kodlanmıştır.
PassThrough 1

Değişmez değer denetiminin içeriği değiştirilmez.
Transform 0

Değişmez değer denetiminin desteklenmeyen biçimlendirme dili öğeleri kaldırılır. Değişmez değer denetimi HTML veya XHTML'yi destekleyen bir tarayıcıda işlenirse, denetimin içeriği değiştirilmez.

Örnekler

Aşağıdaki örnekte özelliğin nasıl ayarlanacağı gösterilmektedir Literal.Mode . Başlangıçta denetimin bildirim temelli söz diziminde olarak ayarlanır Encode . Sayfa yüklendikten sonra, kullanıcı özelliğini olarak ayarlamak Mode için bir düğmeye PassThroughtıklayabilir. Bu, özelliğin içeriğinin Literal.Text farklı işlenmesine neden olur.

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

Açıklamalar

Numaralandırma, LiteralMode bir Literal denetimdeki içeriğin nasıl işlendiği için belirtebileceğiniz modları temsil eder. özelliği, Literal.Mode özelliğin içeriğinin Literal.Text davranışını ayarlamak için bu numaralandırma değerlerini kullanır.

belirtirseniz PassThrough, özelliğin Literal.Text tüm içeriği herhangi bir değişiklik yapılmadan cihaza veya tarayıcıya geçirilir. Örneğin, Literal.Text özelliği bir <hr> etiket içeriyorsa, desteklenip desteklenmediğine bakılmaksızın tüm cihazlara ve tarayıcılara gönderilir.

belirtirseniz Encode, özelliğin Text içeriği işlemeden önce HTML ile kodlanmış bir dizeye dönüştürülür. Örneğin, Literal.Text özellik bir <hr> etiket içeriyorsa, cihaza veya tarayıcıya dönüştürülür &lt;hr&gt; ve gönderilir.

belirtirseniz Transformözelliğin Literal.Text işleme davranışı, işlenen işaretleme türüne bağlıdır. Literal Denetim, HTML veya XHTML'yi destekleyen bir cihaz veya tarayıcı için işlendiğinde, belirtilmesi Transform ile PassThroughaynı davranışı üretir. özelliği için Literal.Text tüm işaretleme etiketleri ve öğeleri, istekte bulunan tarayıcı için işlenir.

Literal Denetim, WML veya cHTML gibi HTML veya XHTML dışında bir işaretleme dili için işlendiğinde, desteklenmeyen Transform işaretleme öğelerini kaldırmak için değerini kullanabilirsiniz. Bu durumda, özelliğin Literal.Text hedeflenen işaretleme dilinde desteklenmeyen işaretleme dili öğeleri denetim için işlenmez. Örneğin, Literal.Text özelliği bir <hr> etiket içeriyorsa, içerik bir WML cihazına gönderilmeden önce etiket kaldırılır. Desteklenmeyen bir etiket içerik içeriyorsa, yalnızca etiket kaldırılır ve içerik cihaza veya tarayıcıya gönderilir. Örneğin, Literal.Text özelliği içeriğini <XYZ>Test</XYZ><XYZ> içeriyorsa, metin Test cihaza veya tarayıcıya gönderilirken ve </XYZ> etiketleri kaldırılır.

Şunlara uygulanır

Ayrıca bkz.