HtmlTextWriter.EncodeAttributeValue 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

根据当前上下文的 HttpRequest 对象的要求，对指定标记特性的值进行编码。

重载

EncodeAttributeValue(String, Boolean)	根据当前上下文的 HttpRequest 对象的要求，对指定标记特性的值进行编码。
EncodeAttributeValue(HtmlTextWriterAttribute, String)	根据当前上下文的 HttpRequest 对象的要求，对指定标记特性的值进行编码。

EncodeAttributeValue(String, Boolean)

根据当前上下文的 HttpRequest 对象的要求，对指定标记特性的值进行编码。

protected:
 System::String ^ EncodeAttributeValue(System::String ^ value, bool fEncode);

protected string EncodeAttributeValue (string value, bool fEncode);

member this.EncodeAttributeValue : string * bool -> string

Protected Function EncodeAttributeValue (value As String, fEncode As Boolean) As String

参数

value

String

包含要编码的特性值的字符串。

fEncode

Boolean

若要对特性值进行编码，则为 true；否则为 false。

返回

String

包含已编码特性值的字符串；如果 value 为空，则为 null；如果 fEncode 为 false，则为包含未编码特性值的字符串。

示例

下面的代码示例演示如何在方法调用 EncodeAttributeValue 中 AddAttribute 将 方法作为参数调用，然后对样式属性值进行 color:blue 编码。

// If the <label> element is rendered and a style
// attribute is not defined, add a style attribute 
// and set its value to blue.
if ( TagKey == HtmlTextWriterTag::Label )
{
   if (  !IsAttributeDefined( HtmlTextWriterAttribute::Style ) )
   {
      AddAttribute( "style", EncodeAttributeValue( "color:blue", true ) );
      Write( NewLine );
      Indent = 3;
      OutputTabs();
   }
}

// If the <label> element is rendered and a style
// attribute is not defined, add a style attribute 
// and set its value to blue.
if (TagKey == HtmlTextWriterTag.Label)
{
    if (!IsAttributeDefined(HtmlTextWriterAttribute.Style))
    {
        AddAttribute("style", EncodeAttributeValue("color:blue", true));
        Write(NewLine);
        Indent = 3;
        OutputTabs();
    }
}

' If the <label> element is rendered and a style
' attribute is not defined, add a style attribute 
' and set its value to blue.
If TagKey = HtmlTextWriterTag.Label Then
    If Not IsAttributeDefined(HtmlTextWriterAttribute.Style) Then
        AddAttribute("style", EncodeAttributeValue("color:blue", True))
        Write(NewLine)
        Indent = 3
        OutputTabs()
    End If
End If

注解

EncodeAttributeValue如果特性不是HtmlTextWriterAttribute枚举值，或者直到运行时才知道，请使用 方法的EncodeAttributeValue(HtmlTextWriterAttribute, String)重载。

方法 EncodeAttributeValue 删除双引号 (“) 、与号 (&) 和小于 (<) ，因此无论输入如何，都不会生成无效标记。 实际编码由 HtmlAttributeEncode 方法执行。

另请参阅

• TextWriter
• HtmlAttributeEncode(String)
• HtmlTextWriterAttribute
• HttpRequest

EncodeAttributeValue(HtmlTextWriterAttribute, String)

根据当前上下文的 HttpRequest 对象的要求，对指定标记特性的值进行编码。

protected:
 virtual System::String ^ EncodeAttributeValue(System::Web::UI::HtmlTextWriterAttribute attrKey, System::String ^ value);

protected virtual string EncodeAttributeValue (System.Web.UI.HtmlTextWriterAttribute attrKey, string value);

abstract member EncodeAttributeValue : System.Web.UI.HtmlTextWriterAttribute * string -> string
override this.EncodeAttributeValue : System.Web.UI.HtmlTextWriterAttribute * string -> string

Protected Overridable Function EncodeAttributeValue (attrKey As HtmlTextWriterAttribute, value As String) As String

参数

attrKey

HtmlTextWriterAttribute

表示标记属性的 HtmlTextWriterAttribute。

value

String

包含要编码的特性值的字符串。

返回

String

包含已编码的属性值的字符串。

注解

方法 EncodeAttributeValue 删除双引号 (“) 、与号 (&) 和小于 (<) ，因此无论输入如何，都不会生成无效标记。 实际编码由 HtmlAttributeEncode 方法执行。

另请参阅

• TextWriter
• HtmlAttributeEncode(String)
• HtmlTextWriterAttribute
• HttpRequest