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 控制項可讓您指定是否對內容進行編碼。
Panel 和 PlaceHolder 控制項會呈現為 div 項目,這個項目會在頁面中建立獨立的區塊,而不是像 Label 和 Literal 控制項一樣用內嵌方式呈現。
總之,如果您想要直接在頁面中呈現文字和控制項,但不想要額外產生任何標記,就使用 Literal 控制項。
對常數控制項中的內容進行編碼
Literal 控制項支援 Mode 屬性 (Property),這個屬性會指定控制項如何處理您在其中加入的標記。您可以將 Mode 屬性設定為這些值:
Transform. 任何加入至控制項的標記都會進行轉換,以符合要求瀏覽器的通訊協定。如果您要將內容呈現到使用非 HTML 通訊協定的行動裝置,則這項設定會很有幫助。
PassThrough. 任何加入至控制項的標記都會按原狀在瀏覽器中呈現。
Encode. 任何加入至控制項的標記都會使用 HtmlEncode 方法來進行編碼,這個方法會將 HTML 編碼方式轉換為其文字表示。例如,<b> 標記將呈現為 <b>。當您想要瀏覽器顯示標記而不是解譯它時,進行編碼會很有幫助。編碼也有助於提高安全性,因為它可協助防止惡意標記在瀏覽器中執行。如果您要顯示來自未受信任來源的字串,則建議您進行編碼。如需詳細資訊,請參閱 HOW TO:利用將 HTML 編碼套用至字串的方法,防止會在 Web 應用程式中發生的指令碼攻擊。
程式碼範例
HOW TO:將 Literal Web 伺服器控制項加入至 Web Form 網頁 (Visual Studio)
類別參考
下表列出與 Literal 控制項相關的類別。
成員 |
描述 |
---|---|
控制項的主要類別。 |
回到頁首