LiteralMode Enumeration

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gibt an, wie der Inhalt in einem Literal-Steuerelement gerendert wird.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Vererbung
Object
ValueType
Enum
LiteralMode

Felder

Encode 2

Der Inhalt des literalen Steuerelements ist HTML-codiert.
PassThrough 1

Der Inhalt des literalen Steuerelements wird nicht geändert.
Transform 0

Die nicht unterstützten Elemente der Markupsprache des literalen Steuerelements werden entfernt. Wenn das literale Steuerelement in einem Browser gerendert wird, der HTML oder XHTML unterstützt, wird der Inhalt des Steuerelements nicht geändert.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die -Eigenschaft festgelegt wird Literal.Mode . Sie wird zunächst in der deklarativen Syntax für das Steuerelement auf Encode festgelegt. Nachdem die Seite geladen wurde, kann der Benutzer auf eine Schaltfläche klicken, um die Mode -Eigenschaft auf PassThroughfestzulegen. Dies bewirkt, dass der Inhalt der Literal.Text -Eigenschaft unterschiedlich gerendert wird.

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

Hinweise

Die LiteralMode Enumeration stellt die Modi dar, die Sie für das Rendern des Inhalts in einem Literal Steuerelement angeben können. Die Literal.Mode -Eigenschaft verwendet diese Enumerationswerte, um das Verhalten des Inhalts der Literal.Text Eigenschaft festzulegen.

Wenn Sie angeben PassThrough, wird der gesamte Inhalt der Literal.Text Eigenschaft ohne Änderungen an das Gerät oder den Browser übergeben. Wenn die Literal.Text Eigenschaft beispielsweise ein <hr> Tag enthält, wird es an alle Geräte und Browser gesendet, unabhängig davon, ob es unterstützt wird.

Wenn Sie angeben Encode, werden die Inhalte für die Text Eigenschaft vor dem Rendern in eine HTML-codierte Zeichenfolge konvertiert. Wenn die Literal.Text Eigenschaft z. B. ein <hr> Tag enthält, wird sie in das Gerät oder den Browser konvertiert &lt;hr&gt; und an das Gerät oder den Browser gesendet.

Wenn Sie angeben Transform, hängt das Renderingverhalten der Literal.Text Eigenschaft vom Typ des gerenderten Markups ab. Wenn das Literal Steuerelement für ein Gerät oder browser gerendert wird, das HTML oder XHTML unterstützt, erzeugt die Angabe Transform das gleiche Verhalten wie die Angabe PassThroughvon . Alle Markuptags und Elemente für die Literal.Text Eigenschaft werden für den anfordernden Browser gerendert.

Wenn das Literal Steuerelement für eine andere Markupsprache als HTML oder XHTML wie WML oder cHTML gerendert wird, können Sie den Transform Wert verwenden, um nicht unterstützte Markupelemente zu entfernen. In diesem Fall werden alle Markupsprachenelemente der Eigenschaft, die Literal.Text in der Zielmarkupsprache nicht unterstützt werden, für das Steuerelement nicht gerendert. Wenn die Literal.Text -Eigenschaft beispielsweise ein <hr> Tag enthält, wird das Tag entfernt, bevor der Inhalt an ein WML-Gerät gesendet wird. Wenn ein nicht unterstütztes Tag Inhalt enthält, wird nur das Tag entfernt, und der Inhalt wird an das Gerät oder den Browser gesendet. Wenn die Literal.Text -Eigenschaft beispielsweise den Inhalt <XYZ>Test</XYZ>enthält, werden die <XYZ> Tags und </XYZ> entfernt, während der Text Test an das Gerät oder den Browser gesendet wird.

Gilt für:

Weitere Informationen