AttributeCollection.AddAttributes(HtmlTextWriter) Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Adiciona atributos da AttributeCollection classe ao HtmlTextWriter objeto responsável por renderizar os atributos como marcação.

public:
 void AddAttributes(System::Web::UI::HtmlTextWriter ^ writer);
public void AddAttributes(System.Web.UI.HtmlTextWriter writer);
member this.AddAttributes : System.Web.UI.HtmlTextWriter -> unit
Public Sub AddAttributes (writer As HtmlTextWriter)

Parâmetros

writer
HtmlTextWriter

Uma instância HtmlTextWriter que escreve o atributo na tag de abertura de um controlo de servidor ASP.NET.

Exemplos

O exemplo seguinte mostra como adicionar novos atributos a um Button controlo de servidor nomeado myButton e a um TextBox controlo de servidor chamado myTextBox. Depois, adiciona esses atributos a um objeto personalizado HtmlTextWriter que irá escrever esses atributos num fluxo de saída para cada um desses controlos.

myButton.Attributes.Clear();
myTextBox.Attributes.Clear();
myButton.Attributes["onClick"] = 
                "javascript:alert('Visiting msn.com');";

myTextBox.Attributes["name"] = "MyTextBox";

myTextBox.Attributes["onBlur"] = 
                 "javascript:alert('Leaving MyTextBox...');";
                           
HttpResponse myHttpResponse = Response;
HtmlTextWriter myHtmlTextWriter  = 
                 new HtmlTextWriter(myHttpResponse.Output);

myButton.Attributes.AddAttributes(myHtmlTextWriter);
myTextBox.Attributes.AddAttributes(myHtmlTextWriter);

myButton.Attributes.Clear()
myTextBox.Attributes.Clear()
myButton.Attributes("onClick") = "javascript:alert('Visiting msn.com');"

myTextBox.Attributes("name") = "MyTextBox"

myTextBox.Attributes("onBlur") = "javascript:alert('Leaving MyTextBox...');"

Dim myHttpResponse As HttpResponse = Response
Dim myHtmlTextWriter As New HtmlTextWriter(myHttpResponse.Output)

myButton.Attributes.AddAttributes(myHtmlTextWriter)
myTextBox.Attributes.AddAttributes(myHtmlTextWriter)

Observações

Este método copia todos os atributos do controlo do servidor para um HtmlTextWriter objeto para que possam ser renderizados na próxima chamada ao RenderBeginTag método.

Para controlos que estão contidos noutros controlos, como Calendar e CheckBoxList, pode-se potencialmente melhorar o desempenho ao renderizar diretamente os controlos contidos. Renderizar diretamente pode ser mais rápido do que renderizar através do controlo do contentor porque os controlos do contentor exigem que copies todos os atributos filhos do controlo para o controlo do contentor e os renderizes depois de serem copiados.

Aplica-se a

Ver também