HtmlTextWriter.EncodeAttributeValue Method

Definition

Encode la valeur de l’attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.Encodes the value of the specified markup attribute based on the requirements of the HttpRequest object of the current context.

Overloads

EncodeAttributeValue(String, Boolean)

Encode la valeur de l’attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.Encodes the value of the specified markup attribute based on the requirements of the HttpRequest object of the current context.

EncodeAttributeValue(HtmlTextWriterAttribute, String)

Encode la valeur de l’attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.Encodes the value of the specified markup attribute based on the requirements of the HttpRequest object of the current context.

EncodeAttributeValue(String, Boolean)

Encode la valeur de l’attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.Encodes the value of the specified markup attribute based on the requirements of the HttpRequest object of the current context.

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

Parameters

value
String

Chaîne contenant la valeur d’attribut à encoder.A string containing the attribute value to encode.

fEncode
Boolean

true pour encoder la valeur d’attribut ; sinon, false.true to encode the attribute value; otherwise, false.

Returns

String

Chaîne contenant la valeur d’attribut encodée, null si value est vide ou la valeur d’attribut non encodée si fEncode est false.A string containing the encoded attribute value, null if value is empty, or the unencoded attribute value if fEncode is false.

Examples

L’exemple de code suivant montre comment appeler la méthode EncodeAttributeValue en tant que paramètre dans un appel de méthode AddAttribute, puis encode une valeur d’attribut de style color:blue.The following code example shows how to call the EncodeAttributeValue method as a parameter in an AddAttribute method call, and then encodes a color:blue style attribute value.

// 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

Remarks

Utilisez la surcharge EncodeAttributeValue de la méthode EncodeAttributeValue(HtmlTextWriterAttribute, String) si l’attribut n’est pas une valeur d’énumération HtmlTextWriterAttribute ou s’il n’est pas connu jusqu’au moment de l’exécution.Use the EncodeAttributeValue overload of the EncodeAttributeValue(HtmlTextWriterAttribute, String) method if the attribute is not an HtmlTextWriterAttribute enumeration value or is not known until run time.

La méthode EncodeAttributeValue supprime les guillemets doubles ("), les esperluettes (&) et les signes inférieur à (<) afin que les balises non valides ne soient pas générées, quelle que soit l’entrée.The EncodeAttributeValue method removes double quotation marks ("), ampersands (&), and less than signs (<) so that invalid tags are not generated, regardless of the input. L’encodage réel est exécuté par la méthode HtmlAttributeEncode.The actual encoding is performed by the HtmlAttributeEncode method.

See also

EncodeAttributeValue(HtmlTextWriterAttribute, String)

Encode la valeur de l’attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.Encodes the value of the specified markup attribute based on the requirements of the HttpRequest object of the current context.

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

Parameters

attrKey
HtmlTextWriterAttribute

HtmlTextWriterAttribute qui représente l'attribut de balisage.An HtmlTextWriterAttribute representing the markup attribute.

value
String

Chaîne contenant la valeur d’attribut à encoder.A string containing the attribute value to encode.

Returns

String

Chaîne qui contient la valeur de l'attribut encodée.A string containing the encoded attribute value.

Remarks

La méthode EncodeAttributeValue supprime les guillemets doubles ("), les esperluettes (&) et les signes inférieur à (<) afin que les balises non valides ne soient pas générées, quelle que soit l’entrée.The EncodeAttributeValue method removes double quotation marks ("), ampersands (&), and less than signs (<) so that invalid tags are not generated, regardless of the input. L’encodage réel est exécuté par la méthode HtmlAttributeEncode.The actual encoding is performed by the HtmlAttributeEncode method.

See also

Applies to