LiteralMode LiteralMode LiteralMode LiteralMode Enum

Definizione

Specifica come viene eseguito il rendering del contenuto di un controllo Literal.Specifies how the content in a Literal control is rendered.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Ereditarietà

Campi

Encode Encode Encode Encode 2

Il contenuto del controllo letterale è codificato nel linguaggio HTML.The literal control's contents are HTML-encoded.

PassThrough PassThrough PassThrough PassThrough 1

Il contenuto del controllo letterale non viene modificato.The literal control's contents are not modified.

Transform Transform Transform Transform 0

Gli elementi del linguaggio markup non supportati del controllo letterale vengono rimossi.The literal control's unsupported markup-language elements are removed. 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.If the literal control is rendered on a browser that supports HTML or XHTML, the control's contents are not modified.

Esempi

Nell'esempio seguente viene illustrato come impostare la Literal.Mode proprietà.The following example demonstrates how to set the Literal.Mode property. Inizialmente è impostato su Encode nella sintassi dichiarativa per il controllo.It is initially set to Encode in the declarative syntax for the control. Dopo che la pagina è stata caricata, l'utente può fare clic Mode su un PassThroughpulsante per impostare la proprietà su.After the page loads, the user can click a button to set the Mode property to PassThrough. In questo modo il contenuto della Literal.Text proprietà viene sottoposta a rendering in modo diverso.This causes the contents of the Literal.Text property to render differently.

<%@ 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' LiteralMode enumerazione rappresenta le modalità che è possibile specificare per il rendering del contenuto di Literal un controllo.The LiteralMode enumeration represents the modes that you can specify for how the content in a Literal control is rendered. La Literal.Mode proprietà utilizza questi valori di enumerazione per impostare il comportamento del contenuto Literal.Text della proprietà.The Literal.Mode property uses these enumeration values to set the behavior of the contents of the Literal.Text property.

Se si specifica PassThrough, l'intero contenuto Literal.Text della proprietà viene passato al dispositivo o al browser senza alcuna modifica.If you specify PassThrough, the entire contents of the Literal.Text property are passed to the device or browser without any modifications. Se, ad esempio, Literal.Text la proprietà contiene <hr> un tag, viene inviata a tutti i dispositivi e i browser, indipendentemente dal fatto che sia supportata.For example, if the Literal.Text property contains an <hr> tag, it is sent to all devices and browsers regardless of whether it is supported.

Se si specifica Encode, il contenuto Text della proprietà viene convertito in una stringa codificata in formato HTML prima del rendering.If you specify Encode, the contents for the Text property are converted into an HTML-encoded string before rendering. Se, ad esempio, Literal.Text la proprietà contiene <hr> un tag, questo verrà convertito in &lt;hr&gt; e inviato al dispositivo o al browser.For example, if the Literal.Text property contains an <hr> tag, it will be converted to &lt;hr&gt; and sent to the device or browser.

Se si specifica Transform, il comportamento Literal.Text di rendering della proprietà dipende dal tipo di markup di cui viene eseguito il rendering.If you specify Transform, the rendering behavior of the Literal.Text property depends on the type of markup being rendered. Quando viene Literal eseguito il rendering del controllo per un dispositivo o un browser che supporta HTML o Transform XHTML, la specifica di produce PassThroughlo stesso comportamento specificato.When the Literal control is rendered for a device or browser that supports HTML or XHTML, specifying Transform produces the same behavior as specifying PassThrough. Viene eseguito il rendering di tutti i Literal.Text tag e gli elementi di markup per la proprietà per il browser richiedente.All markup tags and elements for the Literal.Text property are rendered for the requesting browser.

Quando viene Literal eseguito il rendering del controllo per un linguaggio di markup diverso da HTML o XHTML, ad esempio WML o cHTML, è Transform possibile usare il valore per rimuovere gli elementi di markup non supportati.When the Literal control is rendered for a markup language other than HTML or XHTML, such as WML or cHTML, you can use the Transform value to remove unsupported markup elements. In questo caso, non viene eseguito il rendering di tutti Literal.Text gli elementi del linguaggio di markup della proprietà che non sono supportati nel linguaggio di markup di destinazione per il controllo.In this case, any markup-language elements of the Literal.Text property that are not supported in the targeted markup language are not rendered for the control. Se, ad esempio, Literal.Text la proprietà contiene <hr> un tag, il tag viene rimosso prima che il contenuto venga inviato a un dispositivo WML.For example, if the Literal.Text property contains an <hr> tag, the tag is removed before the content is sent to a WML device. Se un tag non supportato contiene contenuto, solo il tag viene rimosso e il contenuto viene inviato al dispositivo o al browser.If an unsupported tag contains content, only the tag is removed and the content is sent to the device or browser. Se, ad esempio, Literal.Text la proprietà contiene il <XYZ>Test</XYZ>contenuto, <XYZ> i </XYZ> tag e vengono rimossi mentre il Test testo viene inviato al dispositivo o al browser.For example, if the Literal.Text property contains the content <XYZ>Test</XYZ>, the <XYZ> and </XYZ> tags are removed while the text Test is sent to the device or browser.

Si applica a

Vedi anche