HttpServerUtility.HtmlEncode メソッド

public:
 System::String ^ HtmlEncode(System::String ^ s);

public string HtmlEncode(string s);

member this.HtmlEncode : string -> string

Public Function HtmlEncode (s As String) As String

パラメーター

返品

HTML でエンコードされたテキスト。

例

次の例は、安全でないコードをコード化する可能性がある値を HTML エンコードする方法を示しています。 このコードは、Web ページの分離コード ファイルに存在します。 エンコードする値は、この例では、例を簡略化し、HTML エンコードする可能性がある値の種類を示すためだけにハードコーディングされています。 通常、ユーザーまたは要求から受け取った値を HTML エンコードします。 Result は、 Literal コントロールを参照します。

public partial class _Default : Page
{        
    protected void Page_Load(object sender, EventArgs e)
    {
        Result.Text = Server.HtmlEncode("<script>unsafe</script>");      
    } 
}

Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Result.Text = Server.HtmlEncode("<script>unsafe</script>")
    End Sub
End Class

次の例は前の例に似ていますが、分離コード ファイルにないクラス内から値を HTML エンコードする方法を示しています。

public class SampleClass
{
    public string GetEncodedText()
    {
        return HttpContext.Current.Server.HtmlEncode("<script>unsafe</script>");
    }
}

Public Class SampleClass
    Public Function GetEncodedText() As String
        Return HttpContext.Current.Server.HtmlEncode("<script>unsafe</script>")
    End Function
End Class

注釈

HTML エンコードでは、テキストがブラウザーに正しく表示され、ブラウザーによって HTML として解釈されないことが確認されます。 たとえば、テキスト文字列に小さい記号 (<) または大きい符号 (>) が含まれている場合、ブラウザーはこれらの文字を HTML タグの開始角かっこまたは終角かっことして解釈します。 文字が HTML エンコードされると、 < および >文字列に変換されます。これにより、ブラウザーに小さい記号とより大きい記号が正しく表示されます。

このメソッドは、ASP.NET アプリケーションから実行時に HttpUtility.HtmlEncode メソッドにアクセスする便利な方法です。 内部的には、このメソッドは HttpUtility.HtmlEncode を使用して文字列をエンコードします。

ASP.NET Web ページの分離コード ファイルで、Server プロパティを使用して HttpServerUtility クラスのインスタンスにアクセスします。 分離コード ファイルにないクラスでは、 HttpContext.Current.Server を使用して、 HttpServerUtility クラスのインスタンスにアクセスします。

Web アプリケーションの外部では、 WebUtility クラスを使用して値をエンコードまたはデコードします。

public:
 void HtmlEncode(System::String ^ s, System::IO::TextWriter ^ output);

public void HtmlEncode(string s, System.IO.TextWriter output);

member this.HtmlEncode : string * System.IO.TextWriter -> unit

Public Sub HtmlEncode (s As String, output As TextWriter)

パラメーター

例

次の例では、HTTP による転送用の文字列をエンコードします。 "This is a <Test String>." というテキストを含む TestString という名前の文字列をエンコードし、"This is a EncodedString<Test String>" という名前の文字列にコピーします。

String TestString = "This is a <Test String>.";
StringWriter writer = new StringWriter();
Server.HtmlEncode(TestString, writer);
String EncodedString = writer.ToString();

Dim TestString As String = "This is a <Test String>."
Dim writer As New StringWriter
Server.HtmlEncode(TestString, writer)
Dim EncodedString As String = writer.ToString()
   

注釈

HTML エンコードを使用すると、ブラウザーでテキストが正しく表示され、ブラウザーでは HTML として解釈されません。 たとえば、テキスト文字列に小さい記号 (<) または大きい符号 (>) が含まれている場合、ブラウザーはこれらの文字を HTML タグの開始角かっこまたは終角かっことして解釈します。 これら 2 つの文字の HTML エンコードは、それぞれ < と >です。これにより、ブラウザーに小さい記号とより大きい記号が正しく表示されます。

HtmlEncode は、ASP.NET アプリケーションから実行時に HttpUtility.HtmlEncode メソッドにアクセスする便利な方法です。 内部的には、 HtmlEncode は HttpUtility.HtmlEncode を使用して文字列をエンコードします。

Web アプリケーションの外部で値をエンコードまたはデコードするには、 WebUtility クラスを使用します。