LiteralMode Výčet

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Dědičnost
Object
ValueType
Enum
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 markup-language ovládacího prvku literálu jsou odebrány. Pokud je ovládací prvek literál 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 . V deklarativní syntaxi ovládacího prvku je zpočátku nastavena na Encode . Po načtení stránky může uživatel kliknutím na tlačítko 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 určit pro vykreslení obsahu Literal ovládacího 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 <hr> značku, 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 <hr> značku, převede se na &lt;hr&gt; zařízení nebo prohlížeč a odešle se do něj.

Pokud zadáte Transform, chování Literal.Text vykreslování vlastnosti závisí na typu vykresleného kódu. 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 elementy značek pro Literal.Text vlastnost se vykreslí pro prohlížeč, který žádost požaduje.

Při vykreslení Literal ovládacího prvku pro značkovací jazyk jiný než HTML nebo XHTML, jako je WML nebo cHTML, můžete hodnotu použít Transform k odebrání nepodporovaných elementů značek. V tomto případě žádné značkovací prvky Literal.Text jazyka 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 <hr> značku, před odesláním obsahu do zařízení WML se značka odebere. 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 během odesílání textu Test do zařízení nebo prohlížeče odeberou.

Platí pro

Viz také