HtmlTextWriter.RenderBeforeTag Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Escreve qualquer texto ou espaçamento que ocorra antes da etiqueta de abertura de um elemento de marcação.
protected:
virtual System::String ^ RenderBeforeTag();
protected virtual string RenderBeforeTag();
abstract member RenderBeforeTag : unit -> string
override this.RenderBeforeTag : unit -> string
Protected Overridable Function RenderBeforeTag () As String
Devoluções
O texto ou espaçamento a escrever antes da etiqueta de abertura do elemento de marcação. Se não for sobreposto, null.
Exemplos
O exemplo de código seguinte mostra como sobrescrever o RenderBeforeTag método para determinar se uma classe derivada da HtmlTextWriter classe está prestes a renderizar um <label> elemento. Se sim, a RenderBeforeTag substituição insere a etiqueta de abertura de um <font> elemento imediatamente antes do <label> elemento. Se não estiver a renderizar um <label> elemento, utiliza-se o RenderBeforeTag método base.
// Override the RenderBeforeTag method to add the
// opening tag of a Font element before the
// opening tag of any Label elements rendered by this
// custom markup writer.
virtual String^ RenderBeforeTag() override
{
// Compare the TagName property value to the
// String* label to determine whether the element to
// be rendered is a Label. If it is a Label,
// the opening tag of the Font element, with a Color
// style attribute set to red, is added before
// the Label.
if ( String::Compare( TagName, "label" ) == 0 )
{
return "<font color=\"red\">";
}
// If a Label is not being rendered, use
// the base RenderBeforeTag method.
else
{
return __super::RenderBeforeTag();
}
}
// Override the RenderBeforeTag method to add the
// opening tag of a Font element before the
// opening tag of any Label elements rendered by this
// custom markup writer.
protected override string RenderBeforeTag()
{
// Compare the TagName property value to the
// string label to determine whether the element to
// be rendered is a Label. If it is a Label,
// the opening tag of the Font element, with a Color
// style attribute set to red, is added before
// the Label.
if (String.Compare(TagName, "label") == 0)
{
return "<font color=\"red\">";
}
// If a Label is not being rendered, use
// the base RenderBeforeTag method.
else
{
return base.RenderBeforeTag();
}
}
' Override the RenderBeforeTag method to add the
' opening tag of a Font element before the
' opening tag of any Label elements rendered by this
' custom markup writer.
Protected Overrides Function RenderBeforeTag() As String
' Compare the TagName property value to the
' string label to determine whether the element to
' be rendered is a Label. If it is a Label,
' the opening tag of the Font element, with a Color
' style attribute set to red, is added before
' the Label.
If String.Compare(TagName, "label") = 0 Then
Return "<font color=""red"">"
' If a Label is not being rendered, use
' the base RenderBeforeTag method.
Else
Return MyBase.RenderBeforeTag()
End If
End Function 'RenderBeforeTag
Observações
O RenderBeforeTag método pode ser útil se quiser renderizar tags de abertura adicionais antes da tag de abertura do elemento pretendido.
Notas para Herdeiros
A HtmlTextWriter implementação de classes do RenderBeforeTag() método devolve null. Substitua RenderBeforeTag() se quiseres escrever texto ou espaçamento antes da etiqueta de abertura do elemento.