HtmlTextWriter.AddAttribute Método

Definição

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

Assemblagem:: System.Web.dll

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.

Adiciona o atributo e valor de marcação especificados à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.

Sobrecargas

Name	Description
AddAttribute(String, String)	Adiciona o atributo e valor de marcação especificados à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.
AddAttribute(HtmlTextWriterAttribute, String)	Adiciona o atributo de marcação e o valor do atributo à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.
AddAttribute(String, String, Boolean)	Adiciona o atributo e valor de marcação especificados à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método, com codificação opcional.
AddAttribute(String, String, HtmlTextWriterAttribute)	Adiciona o atributo e valor de marcação especificados, juntamente com um HtmlTextWriterAttribute valor de enumeração, à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Adiciona o atributo de marcação e o valor do atributo à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método, com codificação opcional.

AddAttribute(String, String)

Adiciona o atributo e valor de marcação especificados à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute(string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Parâmetros

name: String

Uma cadeia contendo o nome do atributo a adicionar.

value: String

Uma cadeia contendo o valor a atribuir ao atributo.

Exemplos

O exemplo de código seguinte demonstra como chamar o AddAttribute método antes de o RenderBeginTag chamar. O código chama dois overloads diferentes de AddAttribute e dois overloads diferentes de AddStyleAttribute antes de chamar o RenderBeginTag método para renderizar um <span> elemento no fluxo de saída. O AddAttribute(String, String) método é usado para definir o atributo personalizado nomeado CustomAttribute e o valor personalizado nomeado CustomAttributeValue para o <span> elemento que este código renderiza.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Observações

Use a AddAttribute sobrecarga do AddAttribute(String, String) método se o atributo não for um dos HtmlTextWriterAttribute valores, ou se o atributo não for conhecido até ao tempo de execução.

Para uma instância de qualquer elemento de marcação, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o RenderBeginTag método é chamado, quaisquer atributos adicionados pelo AddAttribute método são renderizados na etiqueta de abertura do elemento. A lista de atributos é então apagada do HtmlTextWriter objeto.

O padrão de codificação para renderizar elementos de marcação é o seguinte:

Use o AddAttribute método para adicionar quaisquer atributos ao elemento.
Use o método RenderBeginTag.
Use outros métodos conforme necessário para renderizar o conteúdo encontrado entre as etiquetas de abertura e fecho do elemento.
Use o método RenderEndTag.

Ver também

Aplica-se a

AddAttribute(HtmlTextWriterAttribute, String)

Adiciona o atributo de marcação e o valor do atributo à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Parâmetros

key: HtmlTextWriterAttribute

E HtmlTextWriterAttribute que representa o atributo de marcação a adicionar ao fluxo de saída.

value: String

Uma cadeia contendo o valor a atribuir ao atributo.

Exemplos

O seguinte exemplo de código mostra como usar a AddAttribute sobrecarga do AddAttribute(HtmlTextWriterAttribute, String) método para adicionar um Onclick atributo a um elemento de marcação e depois definir o seu valor para o seguinte código ECMAScript:

alert('Hello');

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Observações

Use a AddAttribute sobrecarga do AddAttribute(HtmlTextWriterAttribute, String) método para renderizar um atributo de marcação padrão.

Para uma instância de qualquer elemento de marcação, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o RenderBeginTag método é chamado, quaisquer atributos adicionados pelo AddAttribute método são renderizados para a etiqueta de abertura do elemento. A lista de atributos é então apagada do HtmlTextWriter.

O padrão de codificação para renderizar elementos de marcação é o seguinte:

Use o AddAttribute método para adicionar quaisquer atributos ao elemento.
Use o método RenderBeginTag.
Use outros métodos conforme necessário para renderizar o conteúdo encontrado entre as etiquetas de abertura e fecho do elemento.
Use o método RenderEndTag.

Ver também

Aplica-se a

AddAttribute(String, String, Boolean)

Adiciona o atributo e valor de marcação especificados à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método, com codificação opcional.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute(string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Parâmetros

name: String

Uma cadeia contendo o nome do atributo a adicionar.

value: String

Uma cadeia contendo o valor a atribuir ao atributo.

fEndode: Boolean

true codificar o atributo e o seu valor; caso contrário, false.

Exemplos

O exemplo de código seguinte mostra como usar a AddAttribute sobrecarga do AddAttribute(String, String, Boolean) método para garantir que um atributo personalizado, nomeado myattribute, e o seu valor não sejam codificados para um <img> elemento.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Observações

Use a AddAttribute sobrecarga do AddAttribute(String, String, Boolean) método se o atributo não for um dos HtmlTextWriterAttribute valores, ou se o atributo não for conhecido até ser necessário tempo de execução e codificação.

Use o AddAttribute(String, String, Boolean) método com fEncode definido como true, se o atributo puder eventualmente conter uma aspas ("), um sinal menor que (<), ou um e ampersh (&). A chamada ao método codificará o atributo para satisfazer os requisitos do dispositivo requerente. Pode definir fEncode para false, se souber que nenhum destes caracteres será gerado, ou se souber que o atributo já está codificado.

Se o tipo de atributo for Style, o valor não será codificado mesmo que fEndode seja true. Certifique-se de que o valor de estilo é compatível com CSS e não contém código malicioso.

O padrão de codificação para renderizar elementos de marcação é o seguinte:

Use o AddAttribute método para adicionar quaisquer atributos ao elemento.
Use o método RenderBeginTag.
Use outros métodos conforme necessário para renderizar o conteúdo encontrado entre as etiquetas de abertura e fecho do elemento.
Use o método RenderEndTag.

Ver também

Aplica-se a

AddAttribute(String, String, HtmlTextWriterAttribute)

Adiciona o atributo e valor de marcação especificados, juntamente com um HtmlTextWriterAttribute valor de enumeração, à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método.

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute(string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Parâmetros

name: String

Uma cadeia contendo o nome do atributo a adicionar.

value: String

Uma cadeia contendo o valor a atribuir ao atributo.

key: HtmlTextWriterAttribute

Um HtmlTextWriterAttribute que representa o atributo.

Observações

Use a AddAttribute sobrecarga do AddAttribute(String, String, HtmlTextWriterAttribute) método apenas quando herdar da HtmlTextWriter turma. Permite-te criar novos name e key pares para atributos.

Ver também

Aplica-se a

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Adiciona o atributo de marcação e o valor do atributo à etiqueta de abertura do elemento que o HtmlTextWriter objeto cria com uma chamada subsequente ao RenderBeginTag método, com codificação opcional.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Parâmetros

key: HtmlTextWriterAttribute

E HtmlTextWriterAttribute que representa o atributo de marcação a adicionar ao fluxo de saída.

value: String

Uma cadeia contendo o valor a atribuir ao atributo.

fEncode: Boolean

true codificar o atributo e o seu valor; caso contrário, false.

Exemplos

O exemplo de código seguinte demonstra como usar o AddAttribute(HtmlTextWriterAttribute, String, Boolean) método para garantir que o valor da cadeia atribuída a um Alt atributo para um <img> elemento é codificado para o dispositivo solicitante.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Observações

Use a AddAttribute sobrecarga do AddAttribute(HtmlTextWriterAttribute, String, Boolean) método para renderizar um atributo de marcação padrão, com codificação opcional.

Para uma instância de qualquer elemento de marcação, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o RenderBeginTag método é chamado, quaisquer atributos adicionados por são AddAttribute renderizados na etiqueta de abertura do elemento. A lista de atributos é então apagada do HtmlTextWriter objeto.

Use o AddAttribute(HtmlTextWriterAttribute, String, Boolean) método com fEncode definido como true, se o atributo puder eventualmente conter uma aspas ("), um sinal menor que (<), ou um e ampersh (&). A chamada ao método codificará o atributo para satisfazer os requisitos do dispositivo requerente. Pode definir fEncode para false, se souber que nenhum destes caracteres será gerado, ou se souber que o atributo já está codificado.

Se o tipo de atributo for Style, o valor não será codificado mesmo que fEncode seja true. Certifique-se de que o valor de estilo é compatível com CSS e não contém código malicioso.

O padrão de codificação para renderizar elementos de marcação é o seguinte:

Use o AddAttribute método para adicionar quaisquer atributos ao elemento.
Use o método RenderBeginTag.
Use outros métodos conforme necessário para renderizar o conteúdo encontrado entre as etiquetas de abertura e fecho do elemento.
Use o método RenderEndTag.

Ver também

Aplica-se a

Comentários

Esta página foi útil?