LiteralMode Enum
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger hur innehållet i en Literal kontroll återges.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Arv
Fält
| Name | Värde | Description |
|---|---|---|
| Transform | 0 | Literalkontrollens påläggsspråkelement som inte stöds tas bort. Om literalkontrollen återges i en webbläsare som stöder HTML eller XHTML ändras inte kontrollens innehåll. |
| PassThrough | 1 | Innehållet i literalkontrollen ändras inte. |
| Encode | 2 | Innehållet i literalkontrollen är HTML-kodat. |
Exempel
I följande exempel visas hur du Literal.Mode anger egenskapen. Den är ursprungligen inställd Encode på i den deklarativa syntaxen för kontrollen. När sidan har lästs in kan användaren klicka på en knapp för att ange Mode egenskapen till PassThrough. Detta gör att innehållet i Literal.Text egenskapen återges på ett annat sätt.
<%@ 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>
Kommentarer
Uppräkningen LiteralMode representerar de lägen som du kan ange för hur innehållet i en Literal kontroll återges. Egenskapen Literal.Mode använder dessa uppräkningsvärden för att ange beteendet för innehållet i Literal.Text egenskapen.
Om du anger PassThroughskickas hela innehållet i Literal.Text egenskapen till enheten eller webbläsaren utan några ändringar. Om egenskapen Literal.Text till exempel innehåller en <hr> tagg skickas den till alla enheter och webbläsare oavsett om den stöds.
Om du anger Encodekonverteras innehållet för Text egenskapen till en HTML-kodad sträng före återgivning. Om egenskapen Literal.Text till exempel innehåller en <hr> tagg konverteras den till <hr> och skickas till enheten eller webbläsaren.
Om du anger Transformberor återgivningsbeteendet för Literal.Text egenskapen på vilken typ av markering som återges. När kontrollen Literal återges för en enhet eller webbläsare som har stöd för HTML eller XHTML genererar inställningen Transform samma beteende som att PassThroughange . Alla påläggstaggar och element för Literal.Text egenskapen återges för den begärande webbläsaren.
Literal När kontrollen återges för ett annat markeringsspråk än HTML eller XHTML, till exempel WML eller cHTML, kan du använda Transform värdet för att ta bort markup-element som inte stöds. I det här fallet återges inte alla markup-language-element Literal.Text i egenskapen som inte stöds i målpåläggsspråket för kontrollen. Om egenskapen Literal.Text till exempel innehåller en <hr> tagg tas taggen bort innan innehållet skickas till en WML-enhet. Om en tagg som inte stöds innehåller innehåll tas endast taggen bort och innehållet skickas till enheten eller webbläsaren. Om egenskapen Literal.Text till exempel innehåller innehållet <XYZ>Test</XYZ>tas taggarna <XYZ> och </XYZ> bort medan texten Test skickas till enheten eller webbläsaren.
