Språk

Literal.Mode Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett uppräkningsvärde som anger hur innehållet i Literal kontrollen återges.

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

Egenskapsvärde

LiteralMode

Ett av uppräkningsvärdena LiteralMode . Standardvärdet är Transform.

Undantag

ArgumentOutOfRangeException

Den angivna typen är inte ett av uppräkningsvärdena LiteralMode .

Exempel

Följande kodexempel visar hur du anger en Literal kontrolls Mode egenskap. Egenskapen Mode är ursprungligen inställd Encode på i kontrollens deklarativa syntax. 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 Text egenskapen återges på ett annat sätt.

Note

I följande exempel används kodmodellen med en fil och kanske inte fungerar korrekt om den kopieras direkt till en kod bakom fil. Det här kodexemplet måste kopieras till en tom textfil som har ett .aspx-tillägg. Mer information om kodmodellen Web Forms finns i ASP.NET Web Forms Page Code Model.

<%@ 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

Använd egenskapen Mode för att ange hur innehållet i en Literal kontroll ska återges. Den här egenskapen anges med ett av uppräkningsvärdena LiteralMode . I följande tabell visas möjliga värden.

Value Description
PassThrough Innehållet i kontrollen ändras inte.
Encode Innehållet i kontrollen konverteras till en HTML-kodad sträng.
Transform Markup-language-element som inte stöds tas bort från innehållet i kontrollen. Om kontrollen Literal återges i en webbläsare som stöder HTML eller XHTML ändras inte kontrollens innehåll.

Om du anger PassThroughskickas hela innehållet i Text egenskapen till enheten eller webbläsaren utan att göra några ändringar. Om Text egenskapen för en kontroll till exempel innehåller en Literal<hr> tagg skickas den till alla enheter och webbläsare oavsett om den stöds eller inte.

Om du anger Encodekonverteras innehållet för Text egenskapen till en HTML-kodad sträng före återgivning. Om Text egenskapen för en kontroll till exempel innehåller en Literal<hr> tagg konverteras den till &lt;Hr&gt; och skickas till enheten eller webbläsaren.

Om du anger Transformberor återgivningsbeteendet för 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 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-språkelement Text i egenskapen som inte stöds i målpåläggsspråket för kontrollen. Om Text egenskapen för en kontroll till exempel innehåller en Literal<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 Text till exempel innehåller innehållet <XYZ>Test</XYZ>tas taggarna <XYZ> och </XYZ> bort och texten "Test" skickas till enheten eller webbläsaren.

Gäller för

Se även