ScriptManager.RegisterExpandoAttribute Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.Extensions.dll

Regista um par nome/valor com o ScriptManager controlo como um atributo personalizado (expando) de um controlo 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 controlo que regista o atributo expando.

controlId
String

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

attributeName
String

O nome do atributo personalizado a registar.

attributeValue
String

O valor do atributo personalizado.

encode
Boolean

true codificar o atributo personalizado que está a ser registado; caso contrário, false.

Exceções

ArgumentNullException

control é null.

ArgumentException

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

-ou-

controlId é null.

-ou-

controlId está vazio.

-ou-

attributeName é null.

-ou-

attributeName está vazio.

-ou-

attributeName já está registado.

Observações

Utiliza-se o método RegisterExpandoAttribute para registar uma propriedade personalizada (expando) para um controlo compatível com renderização parcial de páginas e que não tem dependências Microsoft Ajax Library.

O RegisterExpandoAttribute método regista um par nome/valor como um atributo personalizado para o controlo especificado. A propriedade é definida dinamicamente a partir do ECMAScript (JavaScript) para preservar a compatibilidade XHTML para a marcação do controlo renderizado. Define encode para true se tiveres de escapar de qualquer carácter no valor da propriedade dinâmica.

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

Aplica-se a

Ver também