Sdílet prostřednictvím

Literal.Mode Vlastnost

Definice

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

Získá nebo nastaví hodnotu výčtu, která určuje, jak se obsah v ovládacím Literal prvku vykresluje.

public:
 property System::Web::UI::WebControls::LiteralMode Mode { System::Web::UI::WebControls::LiteralMode get(); void set(System::Web::UI::WebControls::LiteralMode value); };
public System.Web.UI.WebControls.LiteralMode Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.LiteralMode with get, set
Public Property Mode As LiteralMode

Hodnota vlastnosti

LiteralMode

Jedna z hodnot výčtu LiteralMode Výchozí hodnota je Transform.

Výjimky

ArgumentOutOfRangeException

Zadaný typ není jednou z hodnot výčtu LiteralMode .

Příklady

Následující příklad kódu ukazuje, jak nastavit Literal vlastnost ovládacího prvku Mode . Vlastnost Mode je původně nastavena v Encode 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 Text vlastnosti se bude vykreslovat odlišně.

Poznámka:

Následující příklad používá model kódu s jedním souborem a nemusí správně fungovat, pokud je zkopírován přímo do souboru s kódem. Tento příklad kódu se musí zkopírovat do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webového formuláře najdete v tématu ASP.NET Model kódu stránky webového formuláře.

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

Mode Pomocí vlastnosti určete, jak se má vykreslit obsah Literal ovládacího prvku. Tato vlastnost je nastavena pomocí jedné z hodnot výčtu LiteralMode . Následující tabulka uvádí možné hodnoty.

Hodnota Description
PassThrough Obsah ovládacího prvku se nezmění.
Encode Obsah ovládacího prvku se převede na řetězec kódovaný kódem HTML.
Transform Z obsahu ovládacího prvku se odeberou nepodporované elementy jazyka revizí. Literal Pokud je ovládací prvek vykreslen v prohlížeči, který podporuje HTML nebo XHTML, obsah ovládacího prvku se nezmění.

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

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

Pokud zadáte Transform, chování Text vykreslování vlastnosti závisí na typu vykreslení revizí. Literal Při vykreslení ovládacího prvku pro zařízení nebo prohlížeč, který podporuje HTML nebo XHTML, určuje Transform stejné chování jako určení PassThrough. Všechny značky a prvky značky pro Text vlastnost se vykreslí pro požadovaný prohlížeč.

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

Platí pro

Viz také