Literal.Mode Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość wyliczenia określającą sposób renderowania zawartości kontrolki 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

Wartość właściwości

LiteralMode

Jedna z LiteralMode wartości wyliczenia. Wartość domyślna to Transform.

Wyjątki

ArgumentOutOfRangeException

Określony typ nie jest jednym LiteralMode z wartości wyliczenia.

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić Literal właściwość kontrolki Mode . Właściwość Mode jest początkowo ustawiona na Encode w składni deklaratywnej dla kontrolki. Po załadowaniu strony użytkownik może kliknąć przycisk, aby ustawić Mode właściwość na PassThrough. Powoduje to, że zawartość Text właściwości jest renderowana inaczej.

Uwaga

W poniższym przykładzie użyto modelu kodu pojedynczego pliku i może nie działać poprawnie, jeśli skopiowano bezpośrednio do pliku kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem aspx. Aby uzyskać więcej informacji na temat modelu kodu Web Forms, zobacz ASP.NET Web Forms Page Code Model (Model kodu strony ASP.NET Web Forms).

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

Użyj właściwości , Mode aby określić sposób renderowania zawartości kontrolki Literal . Ta właściwość jest ustawiana przy użyciu jednej z LiteralMode wartości wyliczenia. W poniższej tabeli wymieniono możliwe wartości.

Wartość	Opis
`PassThrough`	Zawartość kontrolki nie jest modyfikowana.
`Encode`	Zawartość kontrolki jest konwertowana na ciąg zakodowany w formacie HTML.
`Transform`	Nieobsługiwane elementy języka znaczników są usuwane z zawartości kontrolki. Jeśli kontrolka Literal jest renderowana w przeglądarce obsługującej kod HTML lub XHTML, zawartość kontrolki nie zostanie zmodyfikowana.

Jeśli określisz PassThroughwartość , cała zawartość Text właściwości zostanie przekazana do urządzenia lub przeglądarki bez wprowadzania żadnych modyfikacji. Jeśli na przykład Text właściwość Literal kontrolki zawiera <hr> tag, jest ona wysyłana do wszystkich urządzeń i przeglądarek, niezależnie od tego, czy jest obsługiwana, czy nie.

Jeśli określisz Encodewartość , zawartość Text właściwości zostanie przekonwertowana na ciąg zakodowany w formacie HTML przed renderowaniem. Jeśli na przykład Text właściwość kontrolki Literal zawiera <hr> tag, jest konwertowana na i wysyłana do <Hr> urządzenia lub przeglądarki.

Jeśli określisz Transformwartość , zachowanie Text renderowania właściwości zależy od typu renderowanego znaczników. Gdy kontrolka Literal jest renderowana dla urządzenia lub przeglądarki obsługującej kod HTML lub XHTML, określenie Transform powoduje utworzenie tego samego zachowania co określenie PassThrough. Wszystkie znaczniki i elementy właściwości Text są renderowane dla przeglądarki żądającej.

Gdy kontrolka Literal jest renderowana dla języka znaczników innego niż HTML lub XHTML, na przykład WML lub cHTML, możesz użyć Transform wartości , aby usunąć nieobsługiwane elementy znaczników. W takim przypadku wszystkie elementy Text języka znaczników właściwości, które nie są obsługiwane w docelowym języku znaczników, nie są renderowane dla kontrolki. Jeśli na przykład Text właściwość kontrolki Literal zawiera <hr> tag, tag zostanie usunięty przed wysłaniem zawartości do urządzenia WML. Jeśli nieobsługiwany tag zawiera zawartość, zostanie usunięty tylko tag, a zawartość zostanie wysłana do urządzenia lub przeglądarki. Jeśli na przykład Text właściwość zawiera zawartość <XYZ>Test</XYZ>, <XYZ> tagi i </XYZ> zostaną usunięte, a tekst "Test" zostanie wysłany do urządzenia lub przeglądarki.

Dotyczy

Udostępnij przez