HtmlTextWriter.IsAttributeDefined Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Determines whether the specified markup attribute and its value are rendered during the next call to the RenderBeginTag method.
Overloads
IsAttributeDefined(HtmlTextWriterAttribute) |
Determines whether the specified markup attribute and its value are rendered during the next call to the RenderBeginTag method. |
IsAttributeDefined(HtmlTextWriterAttribute, String) |
Determines whether the specified markup attribute and its value are rendered during the next call to the RenderBeginTag method. |
IsAttributeDefined(HtmlTextWriterAttribute)
Determines whether the specified markup attribute and its value are rendered during the next call to the RenderBeginTag method.
protected:
bool IsAttributeDefined(System::Web::UI::HtmlTextWriterAttribute key);
protected bool IsAttributeDefined (System.Web.UI.HtmlTextWriterAttribute key);
member this.IsAttributeDefined : System.Web.UI.HtmlTextWriterAttribute -> bool
Protected Function IsAttributeDefined (key As HtmlTextWriterAttribute) As Boolean
Parameters
The HtmlTextWriterAttribute associated with the markup attribute.
Returns
true
if the attribute is rendered during the next call to the RenderBeginTag method; otherwise, false
.
Examples
The following code example shows how to use an override of the RenderBeginTag method in a class that inherits from the HtmlTextWriter class. The RenderBeginTag override checks whether a <font>
markup element will be rendered. If so, the override calls the IsAttributeDefined method to check whether the <font>
element contains a Size attribute. If not, the AddAttribute method calls the GetAttributeKey method, which defines the Size attribute and sets its value to 30pt
.
// If the tagKey parameter is set to a <font> element
// but a size attribute is not defined on the element,
// the AddStyleAttribute method adds a size attribute
// and sets it to 30 point.
if ( tagKey == HtmlTextWriterTag::Font )
{
if ( !IsAttributeDefined( HtmlTextWriterAttribute::Size ) )
{
AddAttribute( GetAttributeKey( "size" ), "30pt" );
}
}
// If the tagKey parameter is set to a <font> element
// but a size attribute is not defined on the element,
// the AddStyleAttribute method adds a size attribute
// and sets it to 30 point.
if (tagKey == HtmlTextWriterTag.Font)
{
if (!IsAttributeDefined(HtmlTextWriterAttribute.Size))
{
AddAttribute(GetAttributeKey("size"), "30pt");
}
}
' If the tagKey parameter is set to a <font> element
' but a size attribute is not defined on the element,
' the AddStyleAttribute method adds a size attribute
' and sets it to 30 point.
If tagKey = HtmlTextWriterTag.Font Then
If Not IsAttributeDefined(HtmlTextWriterAttribute.Size) Then
AddAttribute(GetAttributeKey("size"), "30pt")
End If
End If
Remarks
To obtain the value to be assigned to the HtmlTextWriterAttribute object, use the IsAttributeDefined(HtmlTextWriterAttribute, String) overload instead of this one.
See also
Applies to
IsAttributeDefined(HtmlTextWriterAttribute, String)
Determines whether the specified markup attribute and its value are rendered during the next call to the RenderBeginTag method.
protected:
bool IsAttributeDefined(System::Web::UI::HtmlTextWriterAttribute key, [Runtime::InteropServices::Out] System::String ^ % value);
protected bool IsAttributeDefined (System.Web.UI.HtmlTextWriterAttribute key, out string value);
member this.IsAttributeDefined : System.Web.UI.HtmlTextWriterAttribute * string -> bool
Protected Function IsAttributeDefined (key As HtmlTextWriterAttribute, ByRef value As String) As Boolean
Parameters
The HtmlTextWriterAttribute associated with the markup attribute.
- value
- String
The value assigned to the attribute.
Returns
true
if the attribute is rendered during the next call to the RenderBeginTag method; otherwise, false
.
Remarks
If the IsAttributeDefined method returns true
, the value to be assigned to the HtmlTextWriterAttribute object is returned in the value
parameter.
See also
Applies to
.NET