HttpEncoder.HtmlEncode(String, TextWriter) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將字串編碼為 HTML 編碼字串。
protected public:
virtual void HtmlEncode(System::String ^ value, System::IO::TextWriter ^ output);
protected internal virtual void HtmlEncode (string value, System.IO.TextWriter output);
abstract member HtmlEncode : string * System.IO.TextWriter -> unit
override this.HtmlEncode : string * System.IO.TextWriter -> unit
Protected Friend Overridable Sub HtmlEncode (value As String, output As TextWriter)
參數
- value
- String
要編碼的字串。
- output
- TextWriter
要在其中寫入編碼值的文字寫入器。
例外狀況
output
為 null
。
備註
下表列出 ASP.NET 編碼邏輯可解碼的字元序列。
字元 | 編碼為 |
---|---|
< (左角括弧) |
< |
> (右角括弧) |
> |
" (雙引號) |
" |
& (& 符號) |
& |
\ (反斜線) |
\ |
從160到255的 ASCII 字元 | &#NNN; ,其中 NNN 是三位數的十進位字元碼 |
如果您覆寫 HtmlEncode 方法,則必須在以雙引號括住或以單引號括住的 HTML 屬性中產生也可以安全的輸出。 這包括 Razor 引擎的剖析,其中標記和程式碼可以合併,例如 <tag attr="@value"> 。 此外,Razor 引擎處理時,@ 運算子不是內容感知的,因此它會呼叫而不是 HtmlEncode HtmlAttributeEncode 。