ScriptManager.RegisterExpandoAttribute Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
control
é null
.
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.