ScriptManager.RegisterArrayDeclaration Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zaregistruje deklaraci pole ECMAScript (JavaScript) pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku.
Přetížení
RegisterArrayDeclaration(Control, String, String) |
Zaregistruje deklaraci pole ECMAScript (JavaScript) pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku. |
RegisterArrayDeclaration(Page, String, String) |
Zaregistruje deklaraci pole ECMAScript (JavaScript) pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku. |
RegisterArrayDeclaration(Control, String, String)
Zaregistruje deklaraci pole ECMAScript (JavaScript) pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku.
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
Ovládací prvek, který registruje pole.
- arrayName
- String
Název pole, které se má zaregistrovat.
- arrayValue
- String
Maticová hodnota nebo hodnoty, které se mají zaregistrovat.
Výjimky
arrayName
je null
.
Poznámky
Tuto metodu RegisterArrayDeclaration použijete k registraci pole klientských skriptů, které je kompatibilní s částečným vykreslováním stránek a nemá žádné závislosti knihovny Microsoft Ajax Library. Tato metoda zaregistruje pole, pokud control
představuje ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, který se aktualizuje. Pokud chcete matici zaregistrovat při každém výskytu asynchronního postbacku, použijte RegisterArrayDeclaration(Page, String, String) přetížení této metody.
Pokud chcete zaregistrovat pole, které se netýká částečných aktualizací, a pokud chcete matici zaregistrovat pouze jednou během počátečního vykreslování stránky, použijte RegisterArrayDeclaration metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.
Metoda RegisterArrayDeclaration určuje, zda je pole s názvem zadaným v parametru arrayName
již zaregistrováno. Pokud ano, metoda přidá hodnoty zadané v arrayValue
. Vzhledem k tomu, že pole, které se má zaregistrovat, je založeno na ArrayList třídě, jsou povoleny duplicity. Pokud zaregistrované pole s názvem neexistuje arrayName
, vytvoří se pole a hodnoty v arrayValue
něm budou přidány.
Pokud chcete do pole zahrnout řetězcové literály, použijte jednoduché uvozovky (') nebo uvozovky (\") v arrayValue
.
Všimněte si, že JavaScript považuje čárku (,) za oddělovač v poli. Více hodnot pole můžete zadat předáním řetězce s oddělovači čárkami v arrayValue
souboru . Oddělení dvou položek čárkou arrayValue
odpovídá volání RegisterArrayDeclaration metody dvakrát, jednou pro každou položku.
Viz také
Platí pro
RegisterArrayDeclaration(Page, String, String)
Zaregistruje deklaraci pole ECMAScript (JavaScript) pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku.
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
Objekt stránky, který registruje pole.
- arrayName
- String
Název pole, které se má zaregistrovat.
- arrayValue
- String
Maticová hodnota nebo hodnoty, které se mají zaregistrovat.
Výjimky
arrayName
je null
.
Poznámky
Tuto metodu RegisterArrayDeclaration použijete k registraci pole klientských skriptů, které je kompatibilní s částečným vykreslováním stránek a nemá žádné závislosti knihovny Microsoft Ajax Library. Tato metoda registruje pole pokaždé, když dojde k asynchronnímu postbacku. Chcete-li zaregistrovat pole pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, aby pole bylo registrováno pouze při aktualizaci panelu, použijte RegisterArrayDeclaration(Control, String, String) přetížení této metody.
Pokud chcete zaregistrovat pole, které se netýká částečných aktualizací, a pokud chcete matici zaregistrovat pouze jednou během počátečního vykreslování stránky, použijte RegisterArrayDeclaration metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.