Udostępnij za pośrednictwem

ScriptManager.RegisterArrayDeclaration Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.Extensions.dll

Rejestruje deklarację tablicy ECMAScript (JavaScript) z ScriptManager kontrolką do użycia z kontrolką UpdatePanel , która znajduje się wewnątrz kontrolki, i dodaje tablicę do strony.

Przeciążenia

RegisterArrayDeclaration(Control, String, String)

Rejestruje deklarację tablicy ECMAScript (JavaScript) z ScriptManager kontrolką do użycia z kontrolką UpdatePanel , która znajduje się wewnątrz kontrolki, i dodaje tablicę do strony.
RegisterArrayDeclaration(Page, String, String)

Rejestruje deklarację tablicy ECMAScript (JavaScript) z ScriptManager kontrolką do użycia z kontrolką UpdatePanel , która znajduje się wewnątrz kontrolki, i dodaje tablicę do strony.

RegisterArrayDeclaration(Control, String, String)

Rejestruje deklarację tablicy ECMAScript (JavaScript) z ScriptManager kontrolką do użycia z kontrolką UpdatePanel , która znajduje się wewnątrz kontrolki, i dodaje tablicę do strony.

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)

Parametry

control
Control

Kontrolka rejestrującą tablicę.

arrayName
String

Nazwa tablicy do zarejestrowania.

arrayValue
String

Wartość tablicy lub wartości do zarejestrowania.

Wyjątki

ArgumentNullException

arrayName to null.

Uwagi

Metoda służy RegisterArrayDeclaration do rejestrowania tablicy skryptów klienta, która jest zgodna z renderowaniem częściowym i nie ma zależności biblioteki Microsoft Ajax. Ta metoda rejestruje tablicę, gdy control reprezentuje kontrolkę, która znajduje się wewnątrz aktualizowanej UpdatePanel kontrolki. Aby zarejestrować tablicę przy każdym wystąpieniu asynchronicznego ogłaszania zwrotnego, użyj RegisterArrayDeclaration(Page, String, String) przeciążenia tej metody.

Jeśli chcesz zarejestrować tablicę, która nie dotyczy aktualizacji częściowych stron, a jeśli chcesz zarejestrować tablicę tylko raz podczas renderowania początkowej strony, użyj RegisterArrayDeclaration metody ClientScriptManager klasy . Odwołanie do ClientScriptManager obiektu można uzyskać z ClientScript właściwości strony.

Metoda RegisterArrayDeclaration określa, czy tablica o nazwie określonej w parametrze arrayName jest już zarejestrowana. Jeśli tak, metoda dodaje wartości określone w pliku arrayValue. Ponieważ tablica do zarejestrowania ArrayList jest oparta na klasie, dozwolone są duplikaty. Jeśli zarejestrowana tablica o nazwie w arrayName pliku nie istnieje, zostanie utworzona tablica i zostaną do niej dodane wartości arrayValue .

Aby uwzględnić literały ciągu w tablicy, użyj znaków pojedynczego cudzysłowu (') lub znaków podwójnego cudzysłowu (\") w pliku arrayValue.

Należy pamiętać, że język JavaScript traktuje przecinek (,) jako ogranicznik w tablicy. Można określić wiele wartości tablicy, przekazując ciąg rozdzielany przecinkami w pliku arrayValue. Oddzielenie dwóch elementów przecinkiem w arrayValue obiekcie jest równoważne wywołaniu RegisterArrayDeclaration metody dwa razy, po jednym raz dla każdego elementu.

Zobacz też

Dotyczy

RegisterArrayDeclaration(Page, String, String)

Rejestruje deklarację tablicy ECMAScript (JavaScript) z ScriptManager kontrolką do użycia z kontrolką UpdatePanel , która znajduje się wewnątrz kontrolki, i dodaje tablicę do strony.

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)

Parametry

page
Page

Obiekt strony rejestrujący tablicę.

arrayName
String

Nazwa tablicy do zarejestrowania.

arrayValue
String

Wartość tablicy lub wartości do zarejestrowania.

Wyjątki

ArgumentNullException

arrayName to null.

Uwagi

Metoda służy RegisterArrayDeclaration do rejestrowania tablicy skryptów klienta, która jest zgodna z renderowaniem częściowym i nie ma zależności biblioteki Microsoft Ajax. Ta metoda rejestruje tablicę za każdym razem, gdy występuje asynchroniczne ogłaszanie zwrotne. Aby zarejestrować tablicę dla kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki, tak aby tablica została zarejestrowana tylko po zaktualizowaniu panelu, użyj RegisterArrayDeclaration(Control, String, String) przeciążenia tej metody.

Jeśli chcesz zarejestrować tablicę, która nie dotyczy aktualizacji częściowych stron, a jeśli chcesz zarejestrować tablicę tylko raz podczas renderowania początkowej strony, użyj RegisterArrayDeclaration metody ClientScriptManager klasy . Odwołanie do ClientScriptManager obiektu można uzyskać z ClientScript właściwości strony.

Zobacz też

Dotyczy