ScriptManager.RegisterArrayDeclaration Método

Definição

Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.

Sobrecargas

Name Description
RegisterArrayDeclaration(Control, String, String)

Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.

RegisterArrayDeclaration(Page, String, String)

Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.

RegisterArrayDeclaration(Control, String, String)

Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.

public:
 static void RegisterArrayDeclaration(System::Web::UI::Control ^ control, System::String ^ arrayName, System::String ^ arrayValue);
public static void RegisterArrayDeclaration(System.Web.UI.Control control, string arrayName, string arrayValue);
static member RegisterArrayDeclaration : System.Web.UI.Control * string * string -> unit
Public Shared Sub RegisterArrayDeclaration (control As Control, arrayName As String, arrayValue As String)

Parâmetros

control
Control

O controlo que regista o array.

arrayName
String

O nome do array a registar.

arrayValue
String

O valor ou valores do array a registar.

Exceções

arrayName é null.

Observações

Utiliza-se o método RegisterArrayDeclaration para registar um array de scripts cliente compatível com renderização de páginas parciais e que não tem dependências Microsoft da Ajax Library. Este método regista o array quando control representa um controlo que está dentro de um UpdatePanel controlo que está a ser atualizado. Para registar um array sempre que ocorre um postback assíncrono, use a RegisterArrayDeclaration(Page, String, String) sobrecarga deste método.

Se quiser registar um array que não se aplica a atualizações parciais de página, e se quiser registar o array apenas uma vez durante a renderização inicial da página, use o RegisterArrayDeclaration método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.

O RegisterArrayDeclaration método determina se um array com o nome especificado no arrayName parâmetro já está registado. Se sim, o método soma os valores especificados em arrayValue. Como o array a registar é baseado na ArrayList classe, são permitidos duplicados. Se um array registado com o nome em arrayName não existir, o array é criado e os valores em arrayValue são adicionados a ele.

Para incluir literais de string no array, use aspas simples (') ou aspas duplas escapadas (\") em arrayValue.

Note que o JavaScript trata uma vírgula (,) como um delimitador num array. Pode especificar múltiplos valores de array passando uma cadeia delimitada por vírgulas em arrayValue. Separar dois itens com uma vírgula em arrayValue é equivalente a chamar o RegisterArrayDeclaration método duas vezes, uma vez para cada item.

Ver também

Aplica-se a

RegisterArrayDeclaration(Page, String, String)

Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.

public:
 static void RegisterArrayDeclaration(System::Web::UI::Page ^ page, System::String ^ arrayName, System::String ^ arrayValue);
public static void RegisterArrayDeclaration(System.Web.UI.Page page, string arrayName, string arrayValue);
static member RegisterArrayDeclaration : System.Web.UI.Page * string * string -> unit
Public Shared Sub RegisterArrayDeclaration (page As Page, arrayName As String, arrayValue As String)

Parâmetros

page
Page

O objeto página que regista o array.

arrayName
String

O nome do array a registar.

arrayValue
String

O valor ou valores do array a registar.

Exceções

arrayName é null.

Observações

Utiliza-se o método RegisterArrayDeclaration para registar um array de scripts cliente compatível com renderização de páginas parciais e que não tem dependências Microsoft da Ajax Library. Este método regista o array sempre que ocorre um postback assíncrono. Para registar um array para um controlo que está dentro de um UpdatePanel controlo, de modo a que o array só seja registado quando o painel for atualizado, use a RegisterArrayDeclaration(Control, String, String) sobrecarga deste método.

Se quiser registar um array que não se aplica a atualizações parciais de página, e se quiser registar o array apenas uma vez durante a renderização inicial da página, use o RegisterArrayDeclaration método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.

Ver também

Aplica-se a