ClientScriptManager.RegisterExpandoAttribute Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Регистрирует пару name/value в качестве настраиваемого атрибута (expando) указанного элемента управления.

Перегрузки

Имя.	Описание
RegisterExpandoAttribute(String, String, String)	Регистрирует пару name/value в качестве настраиваемого атрибута (expando) указанного элемента управления с идентификатором элемента управления, именем атрибута и значением атрибута.
RegisterExpandoAttribute(String, String, String, Boolean)	Регистрирует пару name/value в качестве настраиваемого атрибута (expando) указанного элемента управления, заданного идентификатором элемента управления, именем атрибута, значением атрибута и логическим значением, указывающим, следует ли кодировать значение атрибута.

RegisterExpandoAttribute(String, String, String)

Регистрирует пару name/value в качестве настраиваемого атрибута (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 регистрирует пару name/value в качестве настраиваемого атрибута (expando) в указанном Control. Атрибут expando настраивается динамически из JavaScript для сохранения совместимости XHTML для разметки отрисованного элемента управления. Кавычки и обратные косые строки в значениях настраиваемого атрибута (expando) экранируются. Если вы не хотите экранировать кавычки и обратные косые скобки, вызовите RegisterExpandoAttribute метод перегрузки и задайте encode для параметра значение false.

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

См. также

• Expando

RegisterExpandoAttribute(String, String, String, Boolean)

Регистрирует пару name/value в качестве настраиваемого атрибута (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 регистрирует пару name/value в качестве настраиваемого атрибута (expando) в указанном Control. Атрибут expando настраивается динамически из JavaScript для сохранения совместимости XHTML для разметки отрисованного элемента управления. Задайте параметру encode , true если вам нужно экранировать кавычки и обратные косые скобки в значении атрибута expando.

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

См. также

• Expando