Udostępnij za pośrednictwem


LiteralMode Wyliczenie

Definicja

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

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Dziedziczenie
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 znaczników 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ść . Początkowo jest ustawiona Encode na wartość 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ć dla 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 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 &lt;hr&gt; urządzenie lub przeglądarkę i wysłana do niego.

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 takie samo zachowanie, jak określenie elementu 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, takiego jak 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

Zobacz też