LiteralMode Wyliczenie

Definicja

Określa sposób Literal renderowania zawartości kontrolki.Specifies how the content in a Literal control is rendered.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Dziedziczenie
LiteralMode

Pola

Encode 2

Zawartość kontrolki literału jest zakodowana w formacie HTML.The literal control's contents are HTML-encoded.

PassThrough 1

Zawartość kontrolki Literal nie jest modyfikowana.The literal control's contents are not modified.

Transform 0

Nieobsługiwane elementy języka znaczników w kontrolce literału są usuwane.The literal control's unsupported markup-language elements are removed. Jeśli kontrolka literału jest renderowana w przeglądarce obsługującej język HTML lub XHTML, zawartość kontrolki nie jest modyfikowana.If the literal control is rendered on a browser that supports HTML or XHTML, the control's contents are not modified.

Przykłady

Poniższy przykład ilustruje sposób ustawiania Literal.Mode właściwości.The following example demonstrates how to set the Literal.Mode property. Początkowo jest ustawiona na Encode w składni deklaratywnej dla formantu.It is initially set to Encode in the declarative syntax for the control. Po załadowaniu strony użytkownik może kliknąć przycisk, aby ustawić Mode Właściwość na PassThrough .After the page loads, the user can click a button to set the Mode property to PassThrough. Powoduje to, że zawartość Literal.Text właściwości może być renderowana inaczej.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>

Uwagi

LiteralModeWyliczenie reprezentuje tryby, które można określić w celu Literal renderowania zawartości kontrolki.The LiteralMode enumeration represents the modes that you can specify for how the content in a Literal control is rendered. Literal.ModeWłaściwość używa tych wartości wyliczenia, aby ustawić zachowanie zawartości Literal.Text właściwości.The Literal.Mode property uses these enumeration values to set the behavior of the contents of the Literal.Text property.

Jeśli określisz PassThrough , cała zawartość Literal.Text właściwości zostanie przeniesiona do urządzenia lub przeglądarki bez żadnych modyfikacji.If you specify PassThrough, the entire contents of the Literal.Text property are passed to the device or browser without any modifications. Na przykład, jeśli Literal.Text Właściwość zawiera <hr> tag, jest wysyłana do wszystkich urządzeń i przeglądarek niezależnie od tego, czy jest obsługiwana.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.

Jeśli określisz Encode , zawartość Text właściwości zostanie przekonwertowana na ciąg zakodowany w formacie HTML przed renderowaniem.If you specify Encode, the contents for the Text property are converted into an HTML-encoded string before rendering. Na przykład, jeśli Literal.Text Właściwość zawiera <hr> tag, zostanie przekonwertowana na &lt;hr&gt; urządzenie lub w przeglądarce.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.

Jeśli określisz Transform , zachowanie renderowania Literal.Text właściwości zależy od typu renderowanego znacznika.If you specify Transform, the rendering behavior of the Literal.Text property depends on the type of markup being rendered. Gdy Literal kontrolka jest renderowana dla urządzenia lub przeglądarki obsługującej język HTML lub XHTML, określenie Transform daje takie samo zachowanie jak w przypadku określenia PassThrough .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. Wszystkie Tagi znaczników i elementy Literal.Text właściwości są renderowane dla przeglądarki żądającej.All markup tags and elements for the Literal.Text property are rendered for the requesting browser.

Gdy Literal kontrolka jest renderowana dla języka oznakowania innego niż HTML lub XHTML, takiego jak WML lub cHTML, można użyć Transform wartości, aby usunąć nieobsługiwane elementy znaczników.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. W takim przypadku wszelkie elementy języka znaczników Literal.Text właściwości, które nie są obsługiwane w przeznaczonym do użycia języku oznakowania, nie są renderowane dla kontrolki.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. Na przykład, jeśli Literal.Text Właściwość zawiera <hr> tag, znacznik zostanie usunięty przed wysłaniem zawartości do urządzenia 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. Jeśli nieobsługiwany tag zawiera zawartość, tylko tag jest usuwany, a zawartość jest wysyłana do urządzenia lub przeglądarki.If an unsupported tag contains content, only the tag is removed and the content is sent to the device or browser. Na przykład, jeśli Literal.Text Właściwość zawiera zawartość <XYZ>Test</XYZ> , <XYZ> </XYZ> Tagi i są usuwane podczas Test przesyłania tekstu do urządzenia lub przeglądarki.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.

Dotyczy

Zobacz też