LiteralMode Wyliczenie

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa sposób renderowania zawartości w kontrolce Literal .

public enum class LiteralMode

public enum LiteralMode

type LiteralMode =

Public Enum LiteralMode

Dziedziczenie: Object

ValueType

Enum
LiteralMode

Pola

Encode	2	Zawartość kontrolki literału jest zakodowana w formacie HTML.
PassThrough	1	Zawartość kontrolki literału nie jest modyfikowana.
Transform	0	Nieobsługiwane elementy języka adiustacji kontrolki literału są usuwane. Jeśli kontrolka literału jest renderowana w przeglądarce obsługującej kod HTML lub XHTML, zawartość kontrolki nie jest modyfikowana.

Przykłady

W poniższym przykładzie pokazano, jak ustawić Literal.Mode właściwość. Jest ona początkowo ustawiona na Encode w składni deklaratywnej dla kontrolki. Po załadowaniu strony użytkownik może kliknąć przycisk, aby ustawić Mode właściwość na PassThrough. Powoduje to, że zawartość Literal.Text właściwości jest renderowana inaczej.

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

Uwagi

Wyliczenie LiteralMode reprezentuje tryby, które można określić pod kątem sposobu renderowania zawartości w kontrolce Literal . Właściwość Literal.Mode używa tych wartości wyliczenia, aby ustawić zachowanie zawartości Literal.Text właściwości.

Jeśli określisz PassThroughwartość , cała zawartość Literal.Text właściwości zostanie przekazana do urządzenia lub przeglądarki bez żadnych modyfikacji. Jeśli na przykład Literal.Text właściwość zawiera <hr> tag, jest ona wysyłana do wszystkich urządzeń i przeglądarek niezależnie od tego, czy jest obsługiwana.

Jeśli określisz Encodewartość , zawartość Text właściwości zostanie przekonwertowana na ciąg zakodowany w formacie HTML przed renderowaniem. Jeśli na przykład Literal.Text właściwość zawiera <hr> tag, zostanie przekonwertowana na <hr> i wysłana do urządzenia lub przeglądarki.

Jeśli określisz Transformwartość , zachowanie Literal.Text renderowania właściwości zależy od typu renderowanego znaczników. Gdy kontrolka Literal jest renderowana dla urządzenia lub przeglądarki obsługującej kod HTML lub XHTML, określenie Transform powoduje utworzenie tego samego zachowania co określenie PassThrough. Wszystkie znaczniki i elementy właściwości Literal.Text są renderowane dla przeglądarki żądającej.

Gdy kontrolka Literal jest renderowana dla języka znaczników innego niż HTML lub XHTML, na przykład WML lub cHTML, możesz użyć Transform wartości , aby usunąć nieobsługiwane elementy znaczników. W takim przypadku wszystkie elementy Literal.Text języka znaczników właściwości, które nie są obsługiwane w docelowym języku znaczników, nie są renderowane dla kontrolki. Jeśli na przykład Literal.Text właściwość zawiera <hr> tag, tag zostanie usunięty przed wysłaniem zawartości do urządzenia WML. Jeśli nieobsługiwany tag zawiera zawartość, zostanie usunięty tylko tag, a zawartość zostanie wysłana do urządzenia lub przeglądarki. Jeśli na przykład Literal.Text właściwość zawiera zawartość <XYZ>Test</XYZ>, <XYZ> tagi i </XYZ> zostaną usunięte podczas wysyłania tekstu Test do urządzenia lub przeglądarki.

Dotyczy