Partager via

ClientScriptManager.RegisterExpandoAttribute Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Inscrit une paire nom/valeur en tant qu'attribut personnalisé (expando) du contrôle spécifié.

Surcharges

RegisterExpandoAttribute(String, String, String)

Inscrit une paire nom/valeur en tant qu'attribut personnalisé (expando) du contrôle spécifié en fonction d'un ID de contrôle, d'un nom d'attribut et d'une valeur d'attribut.
RegisterExpandoAttribute(String, String, String, Boolean)

Inscrit une paire nom/valeur en tant qu'attribut personnalisé (expando) du contrôle spécifié selon un ID de contrôle, un nom d'attribut, une valeur d'attribut et une valeur Boolean qui indique s'il faut ou non encoder la valeur d'attribut.

RegisterExpandoAttribute(String, String, String)

Inscrit une paire nom/valeur en tant qu'attribut personnalisé (expando) du contrôle spécifié en fonction d'un ID de contrôle, d'un nom d'attribut et d'une valeur d'attribut.

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)

Paramètres

controlId
String

Control sur la page qui contient l'attribut personnalisé.

attributeName
String

Nom de l'attribut personnalisé à inscrire.

attributeValue
String

Valeur de l'attribut personnalisé.

Remarques

La RegisterExpandoAttribute méthode inscrit une paire nom/valeur en tant qu’attribut personnalisé (expando) sur le fichier spécifié Control. L’attribut expando est défini dynamiquement à partir de JavaScript pour préserver la compatibilité XHTML pour le balisage du contrôle rendu. Les guillemets et les barres obliques inverses dans les valeurs de l’attribut personnalisé (expando) sont échappés. Si vous ne souhaitez pas échapper des guillemets et des barres obliques inverses, appelez la RegisterExpandoAttribute méthode de surcharge et définissez le encode paramètre sur false.

Si l’attribut expando est introuvable ou si le contrôle à ajouter l’attribut expando à introuvable, le script client est toujours émis, mais il n’affecte pas le contrôle.

Voir aussi

S’applique à

RegisterExpandoAttribute(String, String, String, Boolean)

Inscrit une paire nom/valeur en tant qu'attribut personnalisé (expando) du contrôle spécifié selon un ID de contrôle, un nom d'attribut, une valeur d'attribut et une valeur Boolean qui indique s'il faut ou non encoder la valeur d'attribut.

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)

Paramètres

controlId
String

Control sur la page qui contient l'attribut personnalisé.

attributeName
String

Nom de l'attribut personnalisé à inscrire.

attributeValue
String

Valeur de l'attribut personnalisé.

encode
Boolean

Valeur Boolean qui indique s'il faut ou non encoder l'attribut personnalisé à inscrire.

Exemples

L’exemple de code suivant montre comment utiliser la RegisterExpandoAttribute méthode de la ClientScriptManager classe. Le script client dans la page rendue définit l’attribut title d’un <span> élément.

<%@ 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>

Remarques

La RegisterExpandoAttribute méthode inscrit une paire nom/valeur en tant qu’attribut personnalisé (expando) sur le fichier spécifié Control. L’attribut expando est défini dynamiquement à partir de JavaScript pour préserver la compatibilité XHTML pour le balisage du contrôle rendu. Définissez le encode paramètre sur true si vous devez échapper des guillemets et des barres obliques inverses dans la valeur de votre attribut expando.

Si l’attribut expando est introuvable ou si le contrôle à ajouter l’attribut expando à introuvable, le script client est toujours émis, mais il n’affecte pas le contrôle.

Voir aussi

S’applique à