ClientScriptManager.RegisterExpandoAttribute Método

Definição

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

Regista um par nome/valor como um atributo personalizado (expando) do controlo especificado.

Sobrecargas

Name Description
RegisterExpandoAttribute(String, String, String)

Regista um par nome/valor como um atributo personalizado (expando) do controlo especificado, dado um ID de controlo, nome de atributo e valor de atributo.
RegisterExpandoAttribute(String, String, String, Boolean)

Regista um par nome/valor como um atributo personalizado (expando) do controlo especificado, dado um ID de controlo, um nome de atributo, um valor de atributo e um valor booleano que indica se deve codificar o valor do atributo.

RegisterExpandoAttribute(String, String, String)

Regista um par nome/valor como um atributo personalizado (expando) do controlo especificado, dado um ID de controlo, nome de atributo e valor de atributo.

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 registar.

attributeValue
String

O valor do atributo personalizado.

Observações

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

Se o atributo expando não for encontrado ou o controlo para adicionar o atributo expando não for encontrado, o script cliente continua a ser emitido, mas não afetará o controlo.

Ver também

Aplica-se a

RegisterExpandoAttribute(String, String, String, Boolean)

Regista um par nome/valor como um atributo personalizado (expando) do controlo especificado, dado um ID de controlo, um nome de atributo, um valor de atributo e um valor booleano que indica se deve codificar o valor do 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 registar.

attributeValue
String

O valor do atributo personalizado.

encode
Boolean

Um valor booleano que indica se deve codificar o atributo personalizado para registar.

Exemplos

O seguinte exemplo de código demonstra como usar o RegisterExpandoAttribute método da ClientScriptManager classe. O script 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>

Observações

O RegisterExpandoAttribute método regista um par nome/valor como um atributo personalizado (expando) no especificado Control. O atributo expando é definido dinamicamente a partir do JavaScript para preservar a compatibilidade XHTML para a marcação do controlo renderizado. Define o encode parâmetro para true se precisares de escapar das aspas e barras inversas no valor do teu atributo expando.

Se o atributo expando não for encontrado ou o controlo para adicionar o atributo expando não for encontrado, o script cliente continua a ser emitido, mas não afetará o controlo.

Ver também

Aplica-se a