LiteralMode Enumerazione

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica come viene eseguito il rendering del contenuto di un controllo Literal.

public enum class LiteralMode

public enum LiteralMode

type LiteralMode =

Public Enum LiteralMode

Ereditarietà: Object

ValueType

Enum
LiteralMode

Campi

Encode	2	Il contenuto del controllo letterale è codificato nel linguaggio HTML.
PassThrough	1	Il contenuto del controllo letterale non viene modificato.
Transform	0	Gli elementi del linguaggio markup non supportati del controllo letterale vengono rimossi. Se il rendering del controllo letterale viene eseguito in un browser che supporta il linguaggio HTML o XHTML, il contenuto del controllo non viene modificato.

Esempio

Nell'esempio seguente viene illustrato come impostare la Literal.Mode proprietà . Inizialmente è impostato 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 Literal.Text proprietà è diverso.

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

L'enumerazione LiteralMode rappresenta le modalità che è possibile specificare per la modalità di rendering del contenuto in un Literal controllo. La Literal.Mode proprietà utilizza questi valori di enumerazione per impostare il comportamento del contenuto della Literal.Text proprietà .

Se si specifica PassThrough, l'intero contenuto della Literal.Text proprietà viene passato al dispositivo o al browser senza alcuna modifica. Ad esempio, se la Literal.Text proprietà contiene un <hr> tag, viene inviato a tutti i dispositivi e ai browser indipendentemente dal fatto che sia supportato.

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

Se si specifica Transform, il comportamento di rendering della Literal.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 Literal.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 Literal.Text proprietà non supportati nel linguaggio di markup di destinazione non vengono sottoposti a rendering per il controllo . Ad esempio, se la Literal.Text proprietà 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 Literal.Text proprietà contiene il contenuto <XYZ>Test</XYZ>, i <XYZ> tag e </XYZ> vengono rimossi mentre il testo Test viene inviato al dispositivo o al browser.

Si applica a

Condividi tramite