Literal.Mode Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

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

Özel durumlar

ArgumentOutOfRangeException

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 <Hr> 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 Text Literal ö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