Aracılığıyla paylaş


Literal.Mode Özellik

Tanım

Denetimdeki Literal içeriğin nasıl işleneceğini belirten bir numaralandırma değeri alır veya ayarlar.

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

Özellik Değeri

LiteralMode Numaralandırma değerlerinden biri. Varsayılan değer: Transform.

Özel durumlar

Belirtilen tür numaralandırma değerlerinden LiteralMode biri değil.

Örnekler

Aşağıdaki kod örneği, bir Literal denetimin Mode özelliğinin nasıl ayarlandığını gösterir. Mode özelliği başlangıçta denetimin bildirim temelli söz diziminde olarak ayarlanırEncode. Sayfa yüklendikten sonra, kullanıcı özelliğini olarak ayarlamak Mode için bir düğmeye PassThroughtıklayabilir. Bu, özelliğin içeriğinin Text farklı işlenmesine neden olur.

Not

Aşağıdaki örnek tek dosyalı kod modelini kullanır ve doğrudan arka planda kod içeren bir dosyaya kopyalandığında düzgün çalışmayabilir. Bu kod örneği, .aspx uzantısına sahip boş bir metin dosyasına kopyalanmalıdır. Web Forms kod modeli hakkında daha fazla bilgi için bkz. ASP.NET Web Forms Sayfa Kodu Modeli.

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

Bir denetimin Mode içeriğinin Literal nasıl işleneceğini belirtmek için özelliğini kullanın. Bu özellik, numaralandırma değerlerinden LiteralMode biri kullanılarak ayarlanır. Aşağıdaki tabloda olası değerler listelemektedir.

Değer Açıklama
PassThrough Denetimin içeriği değiştirilmez.
Encode Denetimin içeriği HTML ile kodlanmış bir dizeye dönüştürülür.
Transform Desteklenmeyen biçimlendirme dili öğeleri denetimin içeriğinden kaldırılır. Literal Denetim HTML veya XHTML destekleyen bir tarayıcıda işlenirse, denetimin içeriği değiştirilmez.

belirtirseniz PassThrough, özelliğin Text tüm içeriği herhangi bir değişiklik yapılmadan cihaza veya tarayıcıya geçirilir. Örneğin, bir Literal denetimin Text özelliği bir <hr> etiket içeriyorsa, desteklenip desteklenmediği 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, bir Literal denetimin Text özelliği bir <hr> etiket içeriyorsa, bu etiket cihaza veya tarayıcıya dönüştürülür &lt;Hr&gt; ve gönderilir.

belirtirseniz Transform, özelliğin 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 aynı davranışı üretirPassThrough. Özelliğin 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 Text hedeflenen işaretleme dilinde desteklenmeyen işaretleme dili öğeleri denetim için işlenmez. Örneğin, denetimin TextLiteral ö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, Text özelliği içeriğini <XYZ>Test</XYZ><XYZ> içeriyorsa ve </XYZ> etiketleri kaldırılır ve "Test" metni cihaza veya tarayıcıya gönderilir.

Şunlara uygulanır

Ayrıca bkz.