LiteralMode Enum
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u op hoe de inhoud in een Literal besturingselement wordt weergegeven.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Overname
Velden
| Name | Waarde | Description |
|---|---|---|
| Transform | 0 | De niet-ondersteunde opmaaktaalelementen van het letterlijke besturingselement worden verwijderd. Als het letterlijke besturingselement wordt weergegeven in een browser die HTML of XHTML ondersteunt, wordt de inhoud van het besturingselement niet gewijzigd. |
| PassThrough | 1 | De inhoud van het letterlijke besturingselement wordt niet gewijzigd. |
| Encode | 2 | De inhoud van het letterlijke besturingselement wordt met HTML-codering gecodeerd. |
Voorbeelden
In het volgende voorbeeld ziet u hoe u de Literal.Mode eigenschap instelt. Deze is in eerste instantie ingesteld Encode op in de declaratieve syntaxis voor het besturingselement. Nadat de pagina is geladen, kan de gebruiker op een knop klikken om de Mode eigenschap in te stellen op PassThrough. Hierdoor wordt de inhoud van de Literal.Text eigenschap anders weergegeven.
<%@ 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>
Opmerkingen
De LiteralMode opsomming vertegenwoordigt de modi die u kunt opgeven voor hoe de inhoud in een Literal besturingselement wordt weergegeven. De Literal.Mode eigenschap gebruikt deze opsommingswaarden om het gedrag van de inhoud van de Literal.Text eigenschap in te stellen.
Als u opgeeft PassThrough, wordt de volledige inhoud van de Literal.Text eigenschap zonder wijzigingen doorgegeven aan het apparaat of de browser. Als de Literal.Text eigenschap bijvoorbeeld een <hr> tag bevat, wordt deze verzonden naar alle apparaten en browsers, ongeacht of deze wordt ondersteund.
Als u opgeeft Encode, wordt de inhoud voor de Text eigenschap geconverteerd naar een html-gecodeerde tekenreeks voordat deze wordt weergegeven. Als de Literal.Text eigenschap bijvoorbeeld een <hr> tag bevat, wordt deze geconverteerd naar <hr> en verzonden naar het apparaat of de browser.
Als u opgeeft Transform, is het weergavegedrag van de Literal.Text eigenschap afhankelijk van het type markering dat wordt weergegeven. Wanneer het Literal besturingselement wordt weergegeven voor een apparaat of browser die HTML of XHTML ondersteunt, produceert het opgeven Transform hetzelfde gedrag als het PassThroughopgeven. Alle markeringstags en -elementen voor de Literal.Text eigenschap worden weergegeven voor de aanvragende browser.
Wanneer het Literal besturingselement wordt weergegeven voor een andere opmaaktaal dan HTML of XHTML, zoals WML of cHTML, kunt u de Transform waarde gebruiken om niet-ondersteunde opmaakelementen te verwijderen. In dit geval worden eventuele opmaaktaalelementen van de Literal.Text eigenschap die niet worden ondersteund in de doeltaal voor markeringen niet weergegeven voor het besturingselement. Als de Literal.Text eigenschap bijvoorbeeld een <hr> tag bevat, wordt de tag verwijderd voordat de inhoud naar een WML-apparaat wordt verzonden. Als een niet-ondersteunde tag inhoud bevat, wordt alleen de tag verwijderd en wordt de inhoud naar het apparaat of de browser verzonden. Als de Literal.Text eigenschap bijvoorbeeld de inhoud <XYZ>Test</XYZ>bevat, worden de <XYZ> en </XYZ> tags verwijderd terwijl de tekst Test naar het apparaat of de browser wordt verzonden.
