LiteralMode Výčet

Definice

Určuje způsob vykreslení obsahu v ovládacím Literal prvku.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Dědičnost
LiteralMode

Pole

Encode 2

Obsah ovládacího prvku literálu má kódování HTML.

PassThrough 1

Obsah ovládacího prvku literálu se nezmění.

Transform 0

Nepodporované elementy jazyka značky ovládacího prvku literálu jsou odebrány. Pokud je ovládací prvek literálu vykreslen v prohlížeči, který podporuje HTML nebo XHTML, obsah ovládacího prvku se nezmění.

Příklady

Následující příklad ukazuje, jak nastavit Literal.Mode vlastnost. Je zpočátku nastaven na Encode v deklarativní syntaxi ovládacího prvku. Po načtení stránky může uživatel kliknout na tlačítko a nastavit Mode vlastnost na PassThrough. To způsobí, že obsah Literal.Text vlastnosti se vykresluje odlišně.

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

Poznámky

Výčet LiteralMode představuje režimy, které můžete zadat pro vykreslení obsahu v ovládacím Literal prvku. Vlastnost Literal.Mode používá tyto hodnoty výčtu k nastavení chování obsahu Literal.Text vlastnosti.

Pokud zadáte PassThrough, celý obsah Literal.Text vlastnosti se předá zařízení nebo prohlížeči bez jakýchkoli úprav. Pokud Literal.Text například vlastnost obsahuje značku <hr> , odešle se do všech zařízení a prohlížečů bez ohledu na to, jestli je podporovaná.

Pokud zadáte Encode, obsah Text vlastnosti se před vykreslením převede na řetězec kódovaný ve formátu HTML. Pokud Literal.Text například vlastnost obsahuje značku <hr> , převede se na &lt;hr&gt; a odešle se do zařízení nebo prohlížeče.

Pokud zadáte Transform, chování Literal.Text vykreslování vlastnosti závisí na typu vykreslení značek. Při vykreslení Literal ovládacího prvku pro zařízení nebo prohlížeč, který podporuje HTML nebo XHTML, způsobí zadání Transform stejné chování jako při PassThroughzadání . Všechny značky a prvky značek pro Literal.Text vlastnost se vykreslí pro prohlížeč, který žádost požaduje.

Při vykreslení Literal ovládacího prvku pro jiný jazyk značky než HTML nebo XHTML, jako je WML nebo cHTML, můžete hodnotu použít Transform k odebrání nepodporovaných prvků značek. V tomto případě žádné prvky jazyka značky Literal.Text vlastnosti, které nejsou podporovány v cílovém jazyce značky nejsou vykresleny pro ovládací prvek. Pokud Literal.Text například vlastnost obsahuje značku <hr> , značka se odebere před odesláním obsahu do zařízení WML. Pokud nepodporovaná značka obsahuje obsah, odebere se pouze značka a obsah se odešle do zařízení nebo prohlížeče. Pokud Literal.Text například vlastnost obsahuje obsah <XYZ>Test</XYZ>, <XYZ> značky a </XYZ> se odeberou, když se text Test odešle do zařízení nebo prohlížeče.

Platí pro

Viz také