HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Określa, czy określony element znaczników zostanie renderowany na stronie żądania.

protected:
 virtual bool OnTagRender(System::String ^ name, System::Web::UI::HtmlTextWriterTag key);

protected virtual bool OnTagRender (string name, System.Web.UI.HtmlTextWriterTag key);

abstract member OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
override this.OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool

Protected Overridable Function OnTagRender (name As String, key As HtmlTextWriterTag) As Boolean

Parametry

name

String

Ciąg zawierający nazwę elementu do renderowania.

key

HtmlTextWriterTag

Skojarzony HtmlTextWriterTag z elementem.

Zwraca

Boolean

Zawsze wartość true.

Przykłady

Poniższy przykład kodu pokazuje, jak zastąpić metodę OnTagRender . Font Jeśli element jest renderowany, przesłonięcia używają IsAttributeDefined metody w celu określenia, OnTagRender czy Size atrybut jest renderowany. Jeśli tak nie jest, użyje AddAttribute metody , aby utworzyć Size atrybut i ustawić jego wartość na 20pt.

// If a <font> element is to be rendered, check whether it contains
// a size attribute. If it does not, add one and set its value to
// 20 points, then return true.
protected override bool OnTagRender(string name, HtmlTextWriterTag key)
{

    if (key == HtmlTextWriterTag.Font)
    {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Size)))
        {
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt");
            return true;
        }
    }

    // If the element is not a <font> element, use
    // the base functionality of the OnTagRenderMethod.
    return base.OnTagRender(name, key);
}

' If a <font> element is to be rendered, check whether it contains
' a size attribute. If it does not, add one and set its value to
' 20 points, then return true.
Protected Overrides Function OnTagRender( _
    name As String, _
    key As HtmlTextWriterTag) _
As Boolean

    If (key = HtmlTextWriterTag.Font) Then
        If Not (IsAttributeDefined(HtmlTextWriterAttribute.Size)) Then
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt")
            Return True
        End If
    End If

    ' If the element is not a <font> element, use
    ' the base functionality of the OnTagRenderMethod.
    Return MyBase.OnTagRender(name, key)
End Function

Uwagi

Implementacja HtmlTextWriterOnTagRender klasy metody zawsze zwraca wartość true. Przesłonięcia OnTagRender mogą określać, czy element zostanie renderowany na stronie.

Uwagi dotyczące dziedziczenia

Jeśli dziedziczysz z HtmlTextWriter klasy, możesz zastąpić metodę, aby powrócićfalse, aby uniemożliwić renderowanie OnTagRender(String, HtmlTextWriterTag) elementu znaczników w ogóle lub dla określonego języka znaczników. Jeśli na przykład nie chcesz, aby <font> obiekt, z HtmlTextWriter którego pochodzi, renderował element, możesz zastąpić OnTagRender(String, HtmlTextWriterTag) metodę zwracanąfalse, gdy żądana jest strona zawierająca <font> element.

Zobacz też

• TextWriter
• HtmlTextWriterTag