Literal.Mode Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

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í formát 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 zpočátku nastavena na Encode v deklarativní syntaxi ovládacího prvku. Po načtení stránky může uživatel kliknutím na tlačítko nastavit Mode vlastnost na PassThrough. To způsobí, že obsah Text vlastnosti se vykresluje 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 kódu na pozadí. Tento příklad kódu musí být zkopírován do prázdného textového souboru s příponou .aspx. Další informace o modelu kódu Web Forms najdete v tématu ASP.NET Web Forms model kódu stránky.

<%@ 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á obsah Literal ovládacího prvku vykreslit. Tato vlastnost je nastavena pomocí jedné z hodnot výčtu LiteralMode . Následující tabulka uvádí možné hodnoty.

Hodnota	Popis
`PassThrough`	Obsah ovládacího prvku se nezmění.
`Encode`	Obsah ovládacího prvku se převede na řetězec kódovaný ve formátu HTML.
`Transform`	Nepodporované prvky jazyka značky jsou odebrány z obsahu ovládacího prvku. 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, je odeslána 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 Text například vlastnost Literal ovládacího prvku obsahuje <hr> značku, převede se na <Hr> zařízení nebo prohlížeč a odešle se do něj.

Pokud zadáte Transform, chování 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 Text vlastnost se vykreslí pro prohlížeč, který žádost požaduje.

Při vykreslení Literal ovládacího prvku pro značkový jazyk jiný než HTML nebo XHTML, například WML nebo cHTML, můžete hodnotu použít Transform k odebrání nepodporovaných elementů značek. V tomto případě žádné značkovací Text jazyk prvky vlastnosti, které nejsou podporovány v cílovém jazyku značky nejsou vykresleny pro ovládací prvek. 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 pouze značka a obsah se odešle do zařízení nebo prohlížeče. Pokud Text například vlastnost obsahuje obsah <XYZ>Test</XYZ>, <XYZ> značky a </XYZ> se odeberou a do zařízení nebo prohlížeče se odešle text Test.

Platí pro