HtmlTextWriter.AddAttribute Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

Sobrecargas

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

AddAttribute(String, String)

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

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 de caracteres que contém o nome do atributo a ser adicionado.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

Exemplos

O exemplo de código a seguir demonstra como chamar o AddAttribute método antes de chamar o RenderBeginTag método . O código chama duas sobrecargas diferentes de AddAttribute e duas sobrecargas diferentes de antes de AddStyleAttribute chamar o RenderBeginTag método para renderizar um <span> elemento para o fluxo de saída. O AddAttribute(String, String) método é usado para definir o atributo personalizado chamado CustomAttribute e o valor personalizado nomeado CustomAttributeValue para o <span> elemento que esse 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

Comentários

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é o tempo de execução.

Para uma instância de qualquer elemento de marcação fornecido, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o RenderBeginTag método é chamado, todos os AddAttribute atributos adicionados pelo método são renderizados para a marca de abertura do elemento. Em seguida, a lista de atributos é desmarcada 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 marcas de abertura e fechamento do elemento.

• Use o método RenderEndTag.

Confira também

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

AddAttribute(HtmlTextWriterAttribute, String)

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

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

Um HtmlTextWriterAttribute que representa o atributo de marcação a ser adicionado ao fluxo de saída.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

Exemplos

O exemplo de código a seguir mostra como usar a AddAttribute sobrecarga do AddAttribute(HtmlTextWriterAttribute, String) método para adicionar um Onclick atributo a um elemento de marcação e, em seguida, definir 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');")

Comentários

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 fornecido, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o método é chamado, todos os RenderBeginTag atributos adicionados pelo AddAttribute método são renderizados para a marca de abertura do elemento. A lista de atributos é então desmarcada 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 marcas de abertura e fechamento do elemento.

• Use o método RenderEndTag.

Confira também

• TextWriter
• RenderBeginTag
• RenderEndTag()

AddAttribute(String, String, Boolean)

Adiciona o valor e o atributo de marcação especificados à marca de abertura do elemento que o objeto HtmlTextWriter cria com uma chamada subsequente ao método RenderBeginTag, 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 de caracteres que contém o nome do atributo a ser adicionado.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

fEndode

Boolean

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

Exemplos

O exemplo de código a seguir mostra como usar a AddAttribute sobrecarga do AddAttribute(String, String, Boolean) método para garantir que um atributo personalizado, chamado myattribute, e 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()

Comentários

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é que o tempo de execução e a codificação sejam necessários.

Para uma instância de qualquer elemento de marcação fornecido, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o RenderBeginTag método é chamado, todos os AddAttribute atributos adicionados pelo método são renderizados para a marca de abertura do elemento. Em seguida, a lista de atributos é desmarcada do HtmlTextWriter objeto .

Use o AddAttribute(String, String, Boolean) método com definido truecomo fEncode , se o atributo puder conter uma aspa ("), um sinal menor que (<) ou um e comercial (&). A chamada de método codificará o atributo para atender aos requisitos do dispositivo solicitante. Você pode definir fEncodefalsecomo , se souber que nenhum desses 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 se fEndode for true. Verifique se o valor de estilo é compatível com CSS e não contém código mal-intencionado.

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 marcas de abertura e fechamento do elemento.

• Use o método RenderEndTag.

Confira também

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

AddAttribute(String, String, HtmlTextWriterAttribute)

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

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 de caracteres que contém o nome do atributo a ser adicionado.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

key

HtmlTextWriterAttribute

Um HtmlTextWriterAttribute que representa o atributo.

Comentários

Use a AddAttribute sobrecarga do AddAttribute(String, String, HtmlTextWriterAttribute) método somente ao herdar da HtmlTextWriter classe . Ele permite que você crie novos name pares e key para atributos.

Confira também

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Adiciona o atributo de marcação e o valor de atributo à marca de abertura do elemento criado pelo objeto HtmlTextWriter com uma chamada posterior ao método RenderBeginTag, 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

Um HtmlTextWriterAttribute que representa o atributo de marcação a ser adicionado ao fluxo de saída.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

fEncode

Boolean

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

Exemplos

O exemplo de código a seguir demonstra como usar o AddAttribute(HtmlTextWriterAttribute, String, Boolean) método para garantir que o valor da cadeia de caracteres atribuído a um Alt atributo para um <img> elemento seja 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()

Comentários

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 fornecido, a HtmlTextWriter classe mantém uma lista de atributos para esse elemento. Quando o método é chamado, todos os RenderBeginTag atributos adicionados pelo AddAttribute são renderizados para a marca de abertura do elemento. Em seguida, a lista de atributos é desmarcada do HtmlTextWriter objeto .

Use o AddAttribute(HtmlTextWriterAttribute, String, Boolean) método com definido truecomo fEncode , se o atributo puder conter uma aspa ("), um sinal menor que (<) ou um e comercial (&). A chamada de método codificará o atributo para atender aos requisitos do dispositivo solicitante. Você pode definir fEncodefalsecomo , se souber que nenhum desses 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 se fEncode for true. Verifique se o valor de estilo é compatível com CSS e não contém código mal-intencionado.

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 marcas de abertura e fechamento do elemento.

• Use o método RenderEndTag.

Confira também

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)