HtmlTextWriter.OnAttributeRender Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Determina se è possibile eseguire il rendering dell'attributo di markup specificato e del relativo valore nell'elemento di markup corrente.
protected:
virtual bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);
protected virtual bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);
abstract member OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
Protected Overridable Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean
Parametri
- name
- String
Stringa contenente il nome dell'attributo di cui eseguire il rendering.
- value
- String
Stringa contenente il valore assegnato all'attributo.
Oggetto HtmlTextWriterAttribute associato all'attributo di markup.
Restituisce
Sempre true.
Esempio
Nell'esempio di codice seguente viene illustrato come eseguire l'override del OnAttributeRender metodo. Se viene eseguito il rendering di un Size attributo, ma il valore non 30ptè , l'override OnAttributeRender Size chiama il metodo per aggiungere un Size attributo e impostarne il AddAttribute valore su 30pt.
// If a size attribute is to be rendered, compare its value to 30 point.
// If it is not set to 30 point, add the attribute and set the value to 30,
// then return false.
protected override bool OnAttributeRender(string name,
string value,
HtmlTextWriterAttribute key)
{
if (key == HtmlTextWriterAttribute.Size)
{
if (string.Compare(value, "30pt") != 0)
{
AddAttribute("size", "30pt");
return false;
}
}
// If the attribute is not a size attribute, use
// the base functionality of the OnAttributeRender method.
return base.OnAttributeRender(name, value, key);
}
' If a size attribute is to be rendered, compare its value to 30 point.
' If it is not set to 30 point, add the attribute and set the value to 30
' then return false.
Protected Overrides Function OnAttributeRender(name As String, _
value As String, _
key As HtmlTextWriterAttribute) _
As Boolean
If key = HtmlTextWriterAttribute.Size Then
If [String].Compare(value, "30pt") <> 0 Then
AddAttribute("size", "30pt")
Return False
End If
End If
' If the attribute is not a size attribute, use
' the base functionality of the OnAttributeRender method.
Return MyBase.OnAttributeRender(name, value, key)
End Function 'OnAttributeRender
Commenti
L'implementazione HtmlTextWriter della classe del OnAttributeRender metodo restituisce truesempre . Gli OnAttributeRender overridi possono determinare se verrà eseguito il rendering di un attributo alla pagina.
Note per gli eredi
Se si eredita dalla classe, è possibile eseguire l'override del HtmlTextWriter metodo per restituire false per impedire il rendering di un attributo, essere eseguito il rendering su un particolare elemento o eseguire il OnAttributeRender(String, String, HtmlTextWriterAttribute) rendering per un markup specifico. Ad esempio, se l'oggetto derivato da HtmlTextWriter non esegue il rendering dell'attributo agli <table> elementi, è possibile eseguire l'override bgcolor e OnAttributeRender(String, String, HtmlTextWriterAttribute) restituire false quando name passa bgcolor e il valore della TagName proprietà è table.