共用方式為


Literal Web 伺服器控制項概觀

更新:2007 年 11 月

您可以使用 Literal Web 伺服器控制項,做為頁面上其他內容的容器 (Container)。

這個主題包含:

  • 案例

  • 背景

  • 程式碼範例

  • 類別參考

案例

Literal 控制項最常用於將內容動態加入至頁面。

回到頁首

背景

Literal 控制項代表將內容加入至頁面的其中一個選項。若為靜態 (Static) 內容,您可以將標記直接加入至頁面做為 HTML,而不需使用容器。不過,如果您想要以動態方式加入內容,則必須將內容加入至容器。典型容器 (Container) 有 Label 控制項、Literal 控制項、Panel 控制項和 PlaceHolder 控制項。

Literal 控制項和 Label 控制項的不同之處在於,Literal 控制項不會將任何 HTML 項目加入至文字中 (Label 控制項會呈現 span 項目)。因此,Literal 控制項不支援任何樣式屬性 (Attribute),包括位置屬性。不過,Literal 控制項可讓您指定是否對內容進行編碼。

PanelPlaceHolder 控制項會呈現為 div 項目,這個項目會在頁面中建立獨立的區塊,而不是像 LabelLiteral 控制項一樣用內嵌方式呈現。

總之,如果您想要直接在頁面中呈現文字和控制項,但不想要額外產生任何標記,就使用 Literal 控制項。

對常數控制項中的內容進行編碼

Literal 控制項支援 Mode 屬性 (Property),這個屬性會指定控制項如何處理您在其中加入的標記。您可以將 Mode 屬性設定為這些值:

  • Transform. 任何加入至控制項的標記都會進行轉換,以符合要求瀏覽器的通訊協定。如果您要將內容呈現到使用非 HTML 通訊協定的行動裝置,則這項設定會很有幫助。

  • PassThrough. 任何加入至控制項的標記都會按原狀在瀏覽器中呈現。

  • Encode. 任何加入至控制項的標記都會使用 HtmlEncode 方法來進行編碼,這個方法會將 HTML 編碼方式轉換為其文字表示。例如,<b> 標記將呈現為 &lt;b&gt;。當您想要瀏覽器顯示標記而不是解譯它時,進行編碼會很有幫助。編碼也有助於提高安全性,因為它可協助防止惡意標記在瀏覽器中執行。如果您要顯示來自未受信任來源的字串,則建議您進行編碼。如需詳細資訊,請參閱 HOW TO:利用將 HTML 編碼套用至字串的方法,防止會在 Web 應用程式中發生的指令碼攻擊

程式碼範例

HOW TO:將 Literal Web 伺服器控制項加入至 Web Form 網頁 (Visual Studio)

類別參考

下表列出與 Literal 控制項相關的類別。

成員

描述

Literal

控制項的主要類別。

回到頁首

請參閱

參考

Label Web 伺服器控制項概觀