Literal.Mode Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 festgelegt Encode . Nach dem Laden der Seite kann der Benutzer auf eine Schaltfläche klicken, um die Mode Eigenschaft auf festzulegen PassThrough. Dadurch wird der Inhalt der Text Eigenschaft anders gerendert.

Hinweis

Im folgenden Beispiel wird das Einzeldateicodemodell verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn sie direkt in eine CodeBehind-Datei kopiert werden. 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 Markupspracheelemente werden aus dem Inhalt des Steuerelements entfernt. Wenn das Steuerelement in einem Browser gerendert wird, der Literal HTML oder XHTML unterstützt, werden die Inhalte des Steuerelements nicht geändert.

Wenn Sie angeben PassThrough, werden die gesamten Inhalte der Text Eigenschaft an das Gerät oder den Browser übergeben, ohne Änderungen vorzunehmen. Wenn beispielsweise die Text Eigenschaft eines Literal Steuerelements ein <hr> Tag enthält, wird es an alle Geräte und Browser gesendet, 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 beispielsweise die Text Eigenschaft eines Literal Steuerelements ein <hr> Tag enthält, wird es in <Hr> das Gerät oder browser konvertiert und gesendet.

Wenn Sie angeben Transform, hängt das Renderingverhalten der Text Eigenschaft vom Typ des gerenderten Markups ab. Wenn das Steuerelement für ein Gerät oder einen Browser gerendert wird, der Literal HTML oder XHTML unterstützt, erzeugt die Angabe Transform dasselbe Verhalten wie die Angabe PassThrough. 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 gerendert wird, z. B. WML oder cHTML, können Sie den Transform Wert verwenden, um nicht unterstützte Markupelemente zu entfernen. In diesem Fall werden keine Markupspracheelemente der Text Eigenschaft, die in der zielbezogenen Markupsprache nicht unterstützt werden, für das Steuerelement gerendert. Wenn beispielsweise die Text Eigenschaft eines Literal Steuerelements 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 Inhalte enthält, wird nur das Tag entfernt, und der Inhalt wird an das Gerät oder browser gesendet. Wenn die Text Eigenschaft beispielsweise den Inhalt <XYZ>Test</XYZ>enthält, werden die <XYZ> und </XYZ> die Tags entfernt, und der Text "Test" wird an das Gerät oder den Browser gesendet.

Gilt für