Literal.Mode Eigenschaft

  • Referenz

Definition

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

Ruft einen Enumerationswert ab, der angibt, wie der Inhalt im Literal-Steuerelement gerendert wird, oder legt diesen fest.

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

Eigenschaftswert

LiteralMode

Einer der LiteralMode-Enumerationswerte. Der Standardwert ist Transform.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Typ ist kein LiteralMode-Enumerationswert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die -Eigenschaft eines Literal Steuerelements Mode festgelegt wird. Die Mode -Eigenschaft 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 Text -Eigenschaft unterschiedlich gerendert wird.

Hinweis

Im folgenden Beispiel wird das Codemodell mit einer einzelnen Datei verwendet. Es funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx-Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms-Seitencodemodell.

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

Verwenden Sie die Mode -Eigenschaft, um anzugeben, wie der Inhalt eines Literal Steuerelements gerendert werden soll. Diese Eigenschaft wird mithilfe eines der LiteralMode Enumerationswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert BESCHREIBUNG
PassThrough Der Inhalt des Steuerelements wird nicht geändert.
Encode Der Inhalt des Steuerelements wird in eine HTML-codierte Zeichenfolge konvertiert.
Transform Nicht unterstützte Markupsprachelemente werden aus dem Inhalt des Steuerelements entfernt. Wenn das Literal Steuerelement in einem Browser gerendert wird, der HTML oder XHTML unterstützt, wird der Inhalt des Steuerelements nicht geändert.

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

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

Wenn Sie angeben Transform, hängt das Renderingverhalten der Text Eigenschaft vom Typ des gerenderten Markups ab. Wenn das Literal Steuerelement für ein Gerät oder einen 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 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 Markupsprachelemente der -Eigenschaft, die Text in der Zielmarkupsprache nicht unterstützt werden, für das Steuerelement nicht gerendert. Wenn die Text -Eigenschaft eines Literal Steuerelements 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 Text -Eigenschaft beispielsweise den Inhalt <XYZ>Test</XYZ>enthält, werden die <XYZ> Tags und </XYZ> entfernt, und der Text "Test" wird an das Gerät oder den Browser gesendet.

Gilt für:

Weitere Informationen