ScriptManager.RegisterArrayDeclaration Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.