LiteralMode Sabit listesi
Tanım
Ö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şlendiğini belirtir.
public enum class LiteralMode
public enum LiteralMode
type LiteralMode =
Public Enum LiteralMode
- Devralma
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 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 PassThrough
tı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 özelliği bir <hr>
etiket içeriyorsa, cihaza veya tarayıcıya dönüştürülür <hr>
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 aynı davranışı üretirPassThrough
. Özelliğ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.