ClientScriptManager.RegisterExpandoAttribute Methode

  • Referenz

Definition

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

Registriert ein Name-Wert-Paar als benutzerdefiniertes Attribut (Expando-Attribut) des angegebenen Steuerelements.

Überlädt

RegisterExpandoAttribute(String, String, String)

Registriert ein Name-Wert-Paar mithilfe einer bestimmten Steuerelement-ID, eines Attributnamens und eines Attributwerts als benutzerdefiniertes Attribut (Expando-Attribut) des angegebenen Steuerelements.
RegisterExpandoAttribute(String, String, String, Boolean)

Registriert ein Name-Wert-Paar mithilfe einer bestimmten Steuerelement-ID, eines Attributnamens und eines Attributwerts sowie eines booleschen Werts (der angibt, ob der Attributwert codiert werden soll) als benutzerdefiniertes Attribut (Expando-Attribut) des angegebenen Steuerelements.

RegisterExpandoAttribute(String, String, String)

Registriert ein Name-Wert-Paar mithilfe einer bestimmten Steuerelement-ID, eines Attributnamens und eines Attributwerts als benutzerdefiniertes Attribut (Expando-Attribut) des angegebenen Steuerelements.

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)

Parameter

controlId
String

Das Control auf der Seite, die das benutzerdefinierte Attribut enthält.

attributeName
String

Der Name des zu registrierenden benutzerdefinierten Attributs.

attributeValue
String

Der Wert des benutzerdefinierten Attributs.

Hinweise

Die RegisterExpandoAttribute -Methode registriert ein Name-Wert-Paar als benutzerdefiniertes (expando)-Attribut für das angegebene Control. Das expando-Attribut wird dynamisch in JavaScript festgelegt, um die XHTML-Kompatibilität für das Markup des gerenderten Steuerelements beizubehalten. Anführungszeichen und umgekehrte Schrägstriche in den Werten des benutzerdefinierten Attributs (expando) werden mit Escapezeichen versehen. Wenn Sie Anführungszeichen und umgekehrte Schrägstriche nicht escapen möchten, rufen Sie die RegisterExpandoAttribute Überladungsmethode auf, und legen Sie den encode Parameter auf fest false.

Wenn das expando-Attribut nicht gefunden wird oder das Steuerelement zum Hinzufügen des expando-Attributs nicht gefunden wird, wird das Clientskript weiterhin ausgegeben, wirkt sich jedoch nicht auf das Steuerelement aus.

Weitere Informationen

Gilt für:

RegisterExpandoAttribute(String, String, String, Boolean)

Registriert ein Name-Wert-Paar mithilfe einer bestimmten Steuerelement-ID, eines Attributnamens und eines Attributwerts sowie eines booleschen Werts (der angibt, ob der Attributwert codiert werden soll) als benutzerdefiniertes Attribut (Expando-Attribut) des angegebenen Steuerelements.

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)

Parameter

controlId
String

Das Control auf der Seite, die das benutzerdefinierte Attribut enthält.

attributeName
String

Der Name des zu registrierenden benutzerdefinierten Attributs.

attributeValue
String

Der Wert des benutzerdefinierten Attributs.

encode
Boolean

Ein boolescher Wert, der angibt, ob das zu registrierende benutzerdefinierte Attribut codiert werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die RegisterExpandoAttribute -Methode der ClientScriptManager -Klasse verwendet wird. Das Clientskript auf der gerenderten Seite legt das title Attribut eines <span> Elements fest.

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

Hinweise

Die RegisterExpandoAttribute -Methode registriert ein Name-Wert-Paar als benutzerdefiniertes (expando)-Attribut für das angegebene Control. Das expando-Attribut wird dynamisch in JavaScript festgelegt, um die XHTML-Kompatibilität für das Markup des gerenderten Steuerelements beizubehalten. Legen Sie den encode Parameter auf fest true , wenn Sie Anführungszeichen und umgekehrte Schrägstriche im Wert Ihres expando-Attributs escapen müssen.

Wenn das expando-Attribut nicht gefunden wird oder das Steuerelement zum Hinzufügen des expando-Attributs nicht gefunden wird, wird das Clientskript weiterhin ausgegeben, wirkt sich jedoch nicht auf das Steuerelement aus.

Weitere Informationen

Gilt für: