Compartilhar via

ClientScriptManager.RegisterExpandoAttribute Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Registra um par nome/valor como um atributo personalizado (expando) do controle especificado.

Sobrecargas

RegisterExpandoAttribute(String, String, String)

Registra um par nome/valor como um atributo personalizado (expando) do controle especificado, considerando uma ID de controle, um nome de atributo e um valor de atributo especificados.
RegisterExpandoAttribute(String, String, String, Boolean)

Registra um par nome/valor como um atributo personalizado (expando) do controle especificado considerando uma ID de controle, um nome de atributo, um valor de atributo e um valor booliano que indica se é necessário codificar o valor de atributo.

RegisterExpandoAttribute(String, String, String)

Registra um par nome/valor como um atributo personalizado (expando) do controle especificado, considerando uma ID de controle, um nome de atributo e um valor de atributo especificados.

public:
 void RegisterExpandoAttribute(System::String ^ controlId, System::String ^ attributeName, System::String ^ attributeValue);
public void RegisterExpandoAttribute (string controlId, string attributeName, string attributeValue);
member this.RegisterExpandoAttribute : string * string * string -> unit
Public Sub RegisterExpandoAttribute (controlId As String, attributeName As String, attributeValue As String)

Parâmetros

controlId
String

O Control na página que contém o atributo personalizado.

attributeName
String

O nome do atributo personalizado a ser registrado.

attributeValue
String

O valor do atributo personalizado.

Comentários

O RegisterExpandoAttribute método registra um par nome/valor como um atributo personalizado (expando) no especificado Control. O atributo expando é definido dinamicamente do JavaScript para preservar a compatibilidade XHTML para a marcação do controle renderizado. Aspas e barras invertidas nos valores do atributo personalizado (expando) são escapadas. Se você não quiser escapar de aspas e barras invertidas, chame o RegisterExpandoAttribute método de sobrecarga e defina o encode parâmetro como false.

Se o atributo expando não for encontrado ou o controle ao qual adicionar o atributo expando não for encontrado, o script do cliente ainda será emitido, mas não afetará o controle.

Confira também

Aplica-se a

RegisterExpandoAttribute(String, String, String, Boolean)

Registra um par nome/valor como um atributo personalizado (expando) do controle especificado considerando uma ID de controle, um nome de atributo, um valor de atributo e um valor booliano que indica se é necessário codificar o valor de atributo.

public:
 void RegisterExpandoAttribute(System::String ^ controlId, System::String ^ attributeName, System::String ^ attributeValue, bool encode);
public void RegisterExpandoAttribute (string controlId, string attributeName, string attributeValue, bool encode);
member this.RegisterExpandoAttribute : string * string * string * bool -> unit
Public Sub RegisterExpandoAttribute (controlId As String, attributeName As String, attributeValue As String, encode As Boolean)

Parâmetros

controlId
String

O Control na página que contém o atributo personalizado.

attributeName
String

O nome do atributo personalizado a ser registrado.

attributeValue
String

O valor do atributo personalizado.

encode
Boolean

Um valor booliano que indica se o atributo personalizado deve ser codificado para o registro.

Exemplos

O exemplo de código a seguir demonstra como usar o RegisterExpandoAttribute método da ClientScriptManager classe. O script do cliente na página renderizada define o title atributo de um <span> elemento.

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  public void Page_Load(Object sender, EventArgs e)
  {        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;
    
    // Register an expando attribute.
    cs.RegisterExpandoAttribute("Message", "title", "New title from client script.", true);
    
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <span  id="Message" 
            title="Title to be replaced.">
            Place your mouse over this text to see the title.
     </span>           
     </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        
    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Register an expando attribute.
    cs.RegisterExpandoAttribute("Message", "title", "New title from client script.", True)    
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <span  id="Message" 
            title="Title to be replaced.">
            Place your mouse over this text to see the title.
     </span>
     </form>
  </body>
</html>

Comentários

O RegisterExpandoAttribute método registra um par nome/valor como um atributo personalizado (expando) no especificado Control. O atributo expando é definido dinamicamente do JavaScript para preservar a compatibilidade XHTML para a marcação do controle renderizado. Defina o encode parâmetro para true se você precisar escapar de aspas e barras invertidas no valor do atributo expando.

Se o atributo expando não for encontrado ou o controle ao qual adicionar o atributo expando não for encontrado, o script do cliente ainda será emitido, mas não afetará o controle.

Confira também

Aplica-se a