ClientScriptManager.RegisterExpandoAttribute Метод

Определение

Регистрирует пару "имя-значение" как пользовательский (expando) атрибут указанного элемента управления.

Перегрузки

RegisterExpandoAttribute(String, String, String)

Регистрирует пару "имя-значение" как пользовательский (expando) атрибут указанного элемента управления с указанными идентификатором, именем атрибута и значением атрибута.

RegisterExpandoAttribute(String, String, String, Boolean)

Регистрирует пару "имя-значение" как пользовательский (expando) атрибут указанного элемента управления с указанными идентификатором, именем атрибута, значением атрибута и логическим значением, определяющим, будет ли кодироваться значение атрибута.

RegisterExpandoAttribute(String, String, String)

Регистрирует пару "имя-значение" как пользовательский (expando) атрибут указанного элемента управления с указанными идентификатором, именем атрибута и значением атрибута.

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)

Параметры

controlId
String

Элемент управления Control на странице, содержащей пользовательский атрибут.

attributeName
String

Имя регистрируемого пользовательского атрибута.

attributeValue
String

Значение пользовательского атрибута.

Комментарии

Метод RegisterExpandoAttribute регистрирует пару "имя-значение" в качестве настраиваемого атрибута (expando) в указанном Controlобъекте . Атрибут expando задается динамически из JavaScript для сохранения совместимости XHTML для разметки отрисованного элемента управления. Кавычки и обратные косые черти в значениях настраиваемого атрибута (expando) экранируются. Если вы не хотите экранировать кавычки и обратную косую черту, вызовите RegisterExpandoAttribute метод overload и задайте encode для параметра значение false.

Если атрибут expando не найден или элемент управления для добавления атрибута expando не найден, клиентский скрипт по-прежнему создается, но он не повлияет на элемент управления.

См. также раздел

Применяется к

RegisterExpandoAttribute(String, String, String, Boolean)

Регистрирует пару "имя-значение" как пользовательский (expando) атрибут указанного элемента управления с указанными идентификатором, именем атрибута, значением атрибута и логическим значением, определяющим, будет ли кодироваться значение атрибута.

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)

Параметры

controlId
String

Элемент управления Control на странице, содержащей пользовательский атрибут.

attributeName
String

Имя регистрируемого пользовательского атрибута.

attributeValue
String

Значение пользовательского атрибута.

encode
Boolean

Логическое значение, указывающее будет ли кодироваться регистрируемый пользовательский атрибут.

Примеры

В следующем примере кода показано, как использовать RegisterExpandoAttribute метод ClientScriptManager класса . Клиентский скрипт на отрисоченной странице задает title атрибут <span> элемента.

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

Комментарии

Метод RegisterExpandoAttribute регистрирует пару "имя-значение" в качестве настраиваемого атрибута (expando) в указанном Controlобъекте . Атрибут expando задается динамически из JavaScript для сохранения совместимости XHTML для разметки отрисованного элемента управления. encode Задайте для параметра значение , true если необходимо экранировать кавычки и обратные косые черти в значении атрибута expando.

Если атрибут expando не найден или элемент управления для добавления атрибута expando не найден, клиентский скрипт по-прежнему создается, но он не повлияет на элемент управления.

См. также раздел

Применяется к