ScriptManager.RegisterArrayDeclaration Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à página.

Sobrecargas

RegisterArrayDeclaration(Control, String, String)	Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à página.
RegisterArrayDeclaration(Page, String, String)	Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à página.

RegisterArrayDeclaration(Control, String, String)

Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à 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 controle que está registrando a matriz.

arrayName

String

O nome da matriz a ser registrada.

arrayValue

String

O valor ou valores da matriz a serem registrados.

Exceções

ArgumentNullException

arrayName é null.

Comentários

Você usa o RegisterArrayDeclaration método para registrar uma matriz de script de cliente compatível com a renderização de página parcial e que não tem dependências da Biblioteca Ajax Microsoft. Esse método registra a matriz quando control representa um controle que está dentro de um UpdatePanel controle que está sendo atualizado. Para registrar uma matriz sempre que ocorrer um postback assíncrono, use a RegisterArrayDeclaration(Page, String, String) sobrecarga desse método.

Se você quiser registrar uma matriz que não pertence a atualizações de página parcial e se quiser registrar a matriz apenas uma vez durante a renderização inicial da página, use o RegisterArrayDeclaration método da ClientScriptManager classe . Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

O RegisterArrayDeclaration método determina se uma matriz com o nome especificado no arrayName parâmetro já está registrada. Nesse caso, o método adiciona os valores especificados em arrayValue. Como a matriz a ser registrada é baseada na ArrayList classe , duplicatas são permitidas. Se uma matriz registrada com o nome em arrayName não existir, a matriz será criada e os valores em arrayValue serão adicionados a ela.

Para incluir literais de cadeia de caracteres na matriz, use aspas simples (') ou aspas duplas de escape (\") em arrayValue.

Observe que o JavaScript trata uma vírgula (,) como um delimitador em uma matriz. Você pode especificar vários valores de matriz passando uma cadeia de caracteres 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.

Confira também

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à 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 de página que está registrando a matriz.

arrayName

String

O nome da matriz a ser registrada.

arrayValue

String

O valor ou valores da matriz a serem registrados.

Exceções

ArgumentNullException

arrayName é null.

Comentários

Você usa o RegisterArrayDeclaration método para registrar uma matriz de script de cliente compatível com a renderização de página parcial e que não tem dependências da Biblioteca Ajax Microsoft. Esse método registra a matriz sempre que ocorre um postback assíncrono. Para registrar uma matriz para um controle que está dentro de um UpdatePanel controle para que a matriz seja registrada somente quando o painel for atualizado, use a RegisterArrayDeclaration(Control, String, String) sobrecarga desse método.

Se você quiser registrar uma matriz que não pertence a atualizações de página parcial e se quiser registrar a matriz apenas uma vez durante a renderização inicial da página, use o RegisterArrayDeclaration método da ClientScriptManager classe . Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

Confira também

• RegisterArrayDeclaration(Control, String, String)