ScriptManager.RegisterExpandoAttribute Método

  • Referência

Definição

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

Registra um par nome-valor no controle ScriptManager como um atributo personalizado (expando) de um controle especificado.

public:
 static void RegisterExpandoAttribute(System::Web::UI::Control ^ control, System::String ^ controlId, System::String ^ attributeName, System::String ^ attributeValue, bool encode);
public static void RegisterExpandoAttribute (System.Web.UI.Control control, string controlId, string attributeName, string attributeValue, bool encode);
static member RegisterExpandoAttribute : System.Web.UI.Control * string * string * string * bool -> unit
Public Shared Sub RegisterExpandoAttribute (control As Control, controlId As String, attributeName As String, attributeValue As String, encode As Boolean)

Parâmetros

control
Control

O controle que está registrando o atributo expando.

controlId
String

O controle que contém o atributo personalizado na página.

attributeName
String

O nome do atributo personalizado a ser registrado.

attributeValue
String

O valor do atributo personalizado.

encode
Boolean

true para codificar o atributo personalizado que está sendo registrado; caso contrário, false.

Exceções

ArgumentNullException

control é null.

ArgumentException

control não está na árvore de controle da página.

- ou - controlId é null.

- ou - controlId está vazio.

- ou - attributeName é null.

- ou - attributeName está vazio.

- ou - O attributeName já está registrado.

Comentários

Você usa o RegisterExpandoAttribute método para registrar uma propriedade personalizada (expando) para um controle compatível com renderização de página parcial e que não tem dependências da Biblioteca do Microsoft Ajax.

O RegisterExpandoAttribute método registra um par nome/valor como um atributo personalizado para o controle especificado. A propriedade é definida dinamicamente do ECMAScript (JavaScript) para preservar a compatibilidade XHTML para a marcação do controle renderizado. Defina encode como true se você precisa escapar de quaisquer caracteres no valor da propriedade dinâmica.

Se o controle ao qual a propriedade dinâmica será adicionada não for encontrado, ocorrerá um erro de script.

Aplica-se a

Confira também