Sdílet prostřednictvím

ScriptManager.RegisterArrayDeclaration Metoda

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í

Name Description
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ého skriptu, 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, pokud control představuje ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, který se aktualizuje. K registraci pole 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í stránky, a pokud chcete pole 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 pole s názvem zadaným v parametru arrayName je již registrová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 v arrayName neexistuje, vytvoří se pole a hodnoty se arrayValue do něj přidají.

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 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ého skriptu, 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 při každém výskytu asynchronního 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í stránky, a pokud chcete pole 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