LiteralMode Výčet
Definice
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í.
Určuje, jak se obsah v ovládacím prvku Literal vykresluje.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Dědičnost
Pole
| Name | Hodnota | Description |
|---|---|---|
| Transform | 0 | Odeberou se nepodporované elementy jazyka revizí ovládacího prvku literálu. Pokud se literálový ovládací prvek vykresluje v prohlížeči, který podporuje HTML nebo XHTML, obsah ovládacího prvku se nezmění. |
| PassThrough | 1 | Obsah literálového ovládacího prvku se nezmění. |
| Encode | 2 | Obsah literálového ovládacího prvku je kódován kódem HTML. |
Příklady
Následující příklad ukazuje, jak nastavit Literal.Mode vlastnost. Zpočátku je nastavená na 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 Literal.Text vlastnosti se bude vykreslovat 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, jak se obsah Literal ovládacího prvku vykresluje. Tato Literal.Mode vlastnost používá tyto výčtové hodnoty 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 například Literal.Text 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 vlastnosti Text se před vykreslením převede na řetězec kódovaný kódem HTML. Pokud například Literal.Text vlastnost 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í Literal.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 Literal.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 Literal.Text jazyka značek, které nejsou podporovány v cílovém jazyku značek. Pokud například Literal.Text vlastnost 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. Například pokud Literal.Text vlastnost obsahuje obsah <XYZ>Test</XYZ>, <XYZ> a </XYZ> značky se odeberou, když se text Test odešle do zařízení nebo prohlížeče.
