Sdílet prostřednictvím

ScriptManager.RegisterArrayDeclaration Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.Extensions.dll

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

ArgumentNullException

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 arrayValuesouboru . 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

ArgumentNullException

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.

Viz také

Platí pro