Literal.Mode Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore di enumerazione che specifica come deve essere eseguito il rendering del contenuto del controllo Literal.

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

Valore della proprietà

LiteralMode

Uno dei valori dell'enumerazione LiteralMode. Il valore predefinito è Transform.

Eccezioni

ArgumentOutOfRangeException

Il tipo specificato non è uno dei valori dell'enumerazione LiteralMode.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la proprietà di Mode un Literal controllo. La Mode proprietà viene inizialmente impostata su Encode nella sintassi dichiarativa per il controllo. Dopo il caricamento della pagina, l'utente può fare clic su un pulsante per impostare la Mode proprietà su PassThrough. In questo modo il rendering del contenuto della Text proprietà è diverso.

Nota

L'esempio seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione .aspx. Per altre informazioni sul modello di codice Web Form, vedere ASP.NET modello di codice della pagina Web Form.

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

Commenti

Utilizzare la Mode proprietà per specificare la modalità di rendering del contenuto di un Literal controllo. Questa proprietà viene impostata utilizzando uno dei valori di LiteralMode enumerazione . Nella tabella seguente sono elencati i valori possibili.

Valore Descrizione
PassThrough Il contenuto del controllo non viene modificato.
Encode Il contenuto del controllo viene convertito in una stringa con codifica HTML.
Transform Gli elementi del linguaggio di markup non supportati vengono rimossi dal contenuto del controllo. Se il rendering del Literal controllo viene eseguito in un browser che supporta HTML o XHTML, il contenuto del controllo non viene modificato.

Se si specifica PassThrough, l'intero contenuto della Text proprietà viene passato al dispositivo o al browser senza apportare modifiche. Ad esempio, se la Text proprietà di un Literal controllo contiene un <hr> tag, viene inviata a tutti i dispositivi e ai browser, indipendentemente dal fatto che sia supportata o meno.

Se si specifica Encode, il contenuto della Text proprietà viene convertito in una stringa con codifica HTML prima del rendering. Ad esempio, se la Text proprietà di un Literal controllo contiene un <hr> tag, viene convertita &lt;Hr&gt; in e inviata al dispositivo o al browser.

Se si specifica Transform, il comportamento di rendering della Text proprietà dipende dal tipo di markup di cui viene eseguito il rendering. Quando viene eseguito il rendering del Literal controllo per un dispositivo o un browser che supporta HTML o XHTML, specificando Transform produce lo stesso comportamento di specificare PassThrough. Viene eseguito il rendering di tutti i tag di markup e gli elementi per la Text proprietà per il browser richiedente.

Quando viene eseguito il rendering del Literal controllo per un linguaggio di markup diverso da HTML o XHTML, ad esempio WML o cHTML, è possibile usare il Transform valore per rimuovere elementi di markup non supportati. In questo caso, tutti gli elementi del linguaggio di markup della Text proprietà non supportati nel linguaggio di markup di destinazione non vengono sottoposti a rendering per il controllo. Ad esempio, se la Text proprietà di un Literal controllo contiene un <hr> tag, il tag viene rimosso prima che il contenuto venga inviato a un dispositivo WML. Se un tag non supportato contiene contenuto, viene rimosso solo il tag e il contenuto viene inviato al dispositivo o al browser. Ad esempio, se la Text proprietà contiene il contenuto <XYZ>Test</XYZ>, i <XYZ> tag e </XYZ> vengono rimossi e il testo "Test" viene inviato al dispositivo o al browser.

Si applica a

Vedi anche