Literal.Mode Eigenschap
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 wordt een opsommingswaarde opgehaald of ingesteld die aangeeft hoe de inhoud in het Literal besturingselement wordt weergegeven.
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, setPublic Property Mode As LiteralModeWaarde van eigenschap
Een van de LiteralMode opsommingswaarden. De standaardwaarde is Transform.
Uitzonderingen
Het opgegeven type is geen van de LiteralMode opsommingswaarden.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de eigenschap van Literal een Mode besturingselement instelt. De Mode eigenschap wordt 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 Text eigenschap anders weergegeven.
Note
In het volgende voorbeeld wordt het codemodel met één bestand gebruikt en werkt dit mogelijk niet correct als het rechtstreeks naar een code-behind-bestand wordt gekopieerd. Dit codevoorbeeld moet worden gekopieerd naar een leeg tekstbestand met een .aspx-extensie. Zie ASP.NET Web Forms Page Code Model voor meer informatie over het webformuliercodemodel.
<%@ 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
Gebruik de Mode eigenschap om op te geven hoe de inhoud van een Literal besturingselement moet worden weergegeven. Deze eigenschap wordt ingesteld met behulp van een van de LiteralMode opsommingswaarden. De volgende tabel bevat de mogelijke waarden.
| Waarde | Beschrijving |
|---|---|
PassThrough |
De inhoud van het besturingselement wordt niet gewijzigd. |
Encode |
De inhoud van het besturingselement wordt geconverteerd naar een met HTML gecodeerde tekenreeks. |
Transform |
Niet-ondersteunde opmaaktaalelementen worden verwijderd uit de inhoud van het besturingselement. Als het Literal besturingselement wordt weergegeven in een browser die HTML of XHTML ondersteunt, wordt de inhoud van het besturingselement niet gewijzigd. |
Als u opgeeft PassThrough, wordt de volledige inhoud van de Text eigenschap doorgegeven aan het apparaat of de browser zonder wijzigingen aan te brengen. Als de Text eigenschap van een Literal besturingselement bijvoorbeeld een <hr> tag bevat, wordt het verzonden naar alle apparaten en browsers, ongeacht of het wel of niet 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 Text eigenschap van een Literal besturingselement bijvoorbeeld een <hr> tag bevat, wordt het geconverteerd naar <Hr> en verzonden naar het apparaat of de browser.
Als u opgeeft Transform, is het weergavegedrag van de 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 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 alle opmaaktaalelementen van de Text eigenschap die niet worden ondersteund in de doelmarkeringstaal, niet weergegeven voor het besturingselement. Als de Text eigenschap van een Literal besturingselement 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 Text eigenschap bijvoorbeeld de inhoud <XYZ>Test</XYZ>bevat, worden de <XYZ> en </XYZ> tags verwijderd en wordt de tekst 'Test' naar het apparaat of de browser verzonden.
