ScriptManager Třída
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í.
Spravuje ASP.NET knihovny skriptů Ajax a soubory skriptů, částečné vykreslování stránek a generování třídy proxy klientů pro webové a aplikační služby.
public ref class ScriptManager : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")]
public class ScriptManager : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
inherit Control
interface IPostBackDataHandler
interface IPostBackEventHandlerPublic Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler- Dědičnost
- Atributy
- Implementuje
Příklady
Následující příklady ukazují různé scénáře použití ScriptManager ovládacího prvku.
Povolení aktualizací Partial-Page
Následující příklad ukazuje, jak pomocí ScriptManager ovládacího prvku povolit částečné aktualizace stránky. V tomto příkladu CalendarDropDownList se ovládací prvek a ovládací prvek nachází uvnitř UpdatePanel ovládacího prvku. Ve výchozím nastavení je hodnota UpdateMode vlastnosti a hodnota ChildrenAsTriggers vlastnosti je true.Always Podřízené ovládací prvky panelu proto způsobují asynchronní postback.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void DropDownSelection_Change(Object sender, EventArgs e)
{
Calendar1.DayStyle.BackColor =
System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
}
protected void Calendar1_SelectionChanged(object sender, EventArgs e)
{
SelectedDate.Text =
Calendar1.SelectedDate.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
<asp:UpdatePanel ID="UpdatePanel1"
runat="server">
<ContentTemplate>
<asp:Calendar ID="Calendar1"
ShowTitle="True"
OnSelectionChanged="Calendar1_SelectionChanged"
runat="server" />
<div>
Background:
<br />
<asp:DropDownList ID="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White">
White </asp:ListItem>
<asp:ListItem Value="Silver">
Silver </asp:ListItem>
<asp:ListItem Value="DarkGray">
Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki">
Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> D
ark Khaki </asp:ListItem>
</asp:DropDownList>
</div>
<br />
Selected date:
<asp:Label ID="SelectedDate"
runat="server">None.</asp:Label>
</ContentTemplate>
</asp:UpdatePanel>
<br />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
Calendar1.DayStyle.BackColor = _
System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
End Sub
Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
SelectedDate.Text = Calendar1.SelectedDate.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
<asp:UpdatePanel ID="UpdatePanel1"
runat="server">
<ContentTemplate>
<asp:Calendar ID="Calendar1"
ShowTitle="True"
OnSelectionChanged="Calendar1_SelectionChanged"
runat="server" />
<div>
Background:
<br />
<asp:DropDownList ID="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White">
White </asp:ListItem>
<asp:ListItem Value="Silver">
Silver </asp:ListItem>
<asp:ListItem Value="DarkGray">
Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki">
Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> D
ark Khaki </asp:ListItem>
</asp:DropDownList>
</div>
<br />
Selected date:
<asp:Label ID="SelectedDate"
runat="server">None.</asp:Label>
</ContentTemplate>
</asp:UpdatePanel>
<br />
</div>
</form>
</body>
</html>
Zpracování chyb aktualizace Partial-Page a registrace skriptu
Následující příklad ukazuje, jak poskytnout vlastní zpracování chyb během částečné aktualizace stránky. Ve výchozím nastavení se při částečné aktualizaci stránky zobrazí okno se zprávou JavaScriptu. Tento příklad ukazuje, jak použít vlastní zpracování chyb poskytnutím obslužné rutiny události AsyncPostBackError a nastavením AsyncPostBackErrorMessage vlastnosti v obslužné rutině události. Vlastnost můžete také nastavit AllowCustomErrorsRedirect tak, aby se při částečné aktualizaci stránky použila část vlastních chyb souboru Web.config. V tomto příkladu AllowCustomErrorsRedirect se použije výchozí hodnota vlastnosti. To znamená, že pokud soubor Web.config obsahuje prvek customErrors , tento prvek určuje způsob zobrazení chyb. Další informace najdete v tématu customErrors – element (schéma nastavení ASP.NET).
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button1_Click(object sender, EventArgs e)
{
try
{
int a = Int32.Parse(TextBox1.Text);
int b = Int32.Parse(TextBox2.Text);
int res = a / b;
Label1.Text = res.ToString();
}
catch (Exception ex)
{
if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
{
ex.Data["ExtraInfo"] = " You can't divide " +
TextBox1.Text + " by " + TextBox2.Text + ".";
}
throw ex;
}
}
protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
{
if (e.Exception.Data["ExtraInfo"] != null)
{
ScriptManager1.AsyncPostBackErrorMessage =
e.Exception.Message +
e.Exception.Data["ExtraInfo"].ToString();
}
else
{
ScriptManager1.AsyncPostBackErrorMessage =
"An unspecified error occurred.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Error Handling Example</title>
<style type="text/css">
#UpdatePanel1 {
width: 200px; height: 50px;
border: solid 1px gray;
}
#AlertDiv{
left: 40%; top: 40%;
position: absolute; width: 200px;
padding: 12px;
border: #000000 1px solid;
background-color: white;
text-align: left;
visibility: hidden;
z-index: 99;
}
#AlertButtons{
position: absolute; right: 5%; bottom: 5%;
}
</style>
</head>
<body id="bodytag">
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
<Scripts>
<asp:ScriptReference Path="ErrorHandling.js" />
</Scripts>
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
/
<asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
=
<asp:Label ID="Label1" runat="server"></asp:Label><br />
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
</ContentTemplate>
</asp:UpdatePanel>
<div id="AlertDiv">
<div id="AlertMessage">
</div>
<br />
<div id="AlertButtons">
<input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
</div>
</div>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Try
Dim a As Int32
a = Int32.Parse(TextBox1.Text)
Dim b As Int32
b = Int32.Parse(TextBox2.Text)
Dim res As Int32 = a / b
Label1.Text = res.ToString()
Catch ex As Exception
If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
ex.Data("ExtraInfo") = " You can't divide " & _
TextBox1.Text & " by " & TextBox2.Text & "."
End If
Throw ex
End Try
End Sub
Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
If (e.Exception.Data("ExtraInfo") <> Nothing) Then
ScriptManager1.AsyncPostBackErrorMessage = _
e.Exception.Message & _
e.Exception.Data("ExtraInfo").ToString()
Else
ScriptManager1.AsyncPostBackErrorMessage = _
"An unspecified error occurred."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Error Handling Example</title>
<style type="text/css">
#UpdatePanel1 {
width: 200px; height: 50px;
border: solid 1px gray;
}
#AlertDiv{
left: 40%; top: 40%;
position: absolute; width: 200px;
padding: 12px;
border: #000000 1px solid;
background-color: white;
text-align: left;
visibility: hidden;
z-index: 99;
}
#AlertButtons{
position: absolute; right: 5%; bottom: 5%;
}
</style>
</head>
<body id="bodytag">
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
<Scripts>
<asp:ScriptReference Path="ErrorHandling.js" />
</Scripts>
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
/
<asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
=
<asp:Label ID="Label1" runat="server"></asp:Label><br />
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
</ContentTemplate>
</asp:UpdatePanel>
<div id="AlertDiv">
<div id="AlertMessage">
</div>
<br />
<div id="AlertButtons">
<input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
</div>
</div>
</div>
</form>
</body>
</html>
Globalizace data a času, které se zobrazují v prohlížeči
Následující příklad ukazuje, jak nastavit EnableScriptGlobalization vlastnost tak, aby klientský skript mohl zobrazit datum a čas specifické pro jazykovou verzi v prohlížeči. V příkladu Culture je atribut direktivy @ Page nastaven na auto. V důsledku toho první jazyk zadaný v aktuálním nastavení prohlížeče určuje jazykovou verzi a jazykovou verzi uživatelského rozhraní pro stránku. Další informace naleznete v tématu Postupy: Nastavení jazykové verze a jazykové verze uživatelského rozhraní pro ASP.NET globalizace webové stránky.
<%@ Page Language="C#" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
Poznámky
V tomto tématu:
Introduction
Ovládací ScriptManager prvek je centrální pro funkce Ajax v ASP.NET. Ovládací prvek spravuje všechny prostředky ASP.NET Ajax na stránce. To zahrnuje stažení skriptů knihovny Microsoft Ajax Library do prohlížeče a koordinace částečných aktualizací stránek, které jsou povoleny pomocí UpdatePanel ovládacích prvků. Kromě toho ScriptManager vám ovládací prvek umožňuje provádět následující akce:
Zaregistrujte skript, který je kompatibilní s částečnými aktualizacemi stránek. Aby bylo možné spravovat závislosti mezi skriptem a základní knihovnou, všechny skripty, které zaregistrujete, se načtou po skriptu Microsoft Ajax Library.
Určete, jestli se do prohlížeče odesílají vydané nebo ladicí skripty.
Poskytnutí přístupu k metodám webové služby ze skriptu registrací webových služeb v ovládacím ScriptManager prvku.
Poskytnutí přístupu ke službám ASP.NET ověřování, role a profilování aplikačních služeb z klientského skriptu registrací těchto služeb pomocí ScriptManager ovládacího prvku.
Povolte zobrazení funkcí data,čísla a řetězce jazyka ECMAScript (JavaScript), které jsou specifické pro jazykovou verzi v prohlížeči.
Přístup k lokalizačním prostředkům pro vložené soubory skriptů nebo pro samostatné soubory skriptů pomocí ResourceUICultures vlastnosti ScriptReference ovládacího prvku.
Zaregistrujte serverové ovládací prvky, které implementují IExtenderControl ovládací prvek nebo IScriptControl rozhraní, ScriptManager aby se vykresloval skript vyžadovaný klientskými komponentami a chováním.
Partial-Page Rendering
Schopnost ASP.NET stránky podporovat částečné vykreslování stránek je řízena následujícími faktory:
Vlastnost ScriptManager ovládacího prvku EnablePartialRendering musí být
true(výchozí hodnota).Na stránce musí být alespoň jeden UpdatePanel ovládací prvek.
Vlastnost SupportsPartialRendering musí být
true(výchozí hodnota). SupportsPartialRendering Pokud vlastnost není explicitně nastavena, její hodnota je založena na možnostech prohlížeče.
Hodnotu EnablePartialRendering vlastnosti můžete přepsat v době běhu nebo před událostí stránky Init . Pokud se pokusíte změnit tuto vlastnost po události stránky Init , InvalidOperationException vyvolá se výjimka.
Pokud je podporováno částečné vykreslování stránek, ScriptManager ovládací prvek vykresluje skript, který povolí asynchronní postbacky a částečné aktualizace stránky. Oblasti stránky, které se mají aktualizovat, jsou určeny pomocí UpdatePanel ovládacích prvků. Ovládací ScriptManager prvek zpracovává asynchronní postbacky a aktualizuje pouze oblasti stránky, které je třeba aktualizovat. Další informace o částečném vykreslování stránek najdete v tématu Partial-Page Přehled vykreslování. Další informace o podmínkách, které způsobují aktualizaci, naleznete v tématu Přehled ovládacího prvku UpdatePanel.
Použití ovládacího prvku ScriptManager se stránkami předlohy, uživatelskými ovládacími prvky a dalšími podřízenými komponentami
Stránka může obsahovat pouze jeden ScriptManager ovládací prvek v hierarchii. Pokud chcete zaregistrovat služby a skripty pro vnořené stránky, uživatelské ovládací prvky nebo komponenty, pokud nadřazená stránka již ovládací prvek obsahuje ScriptManager , použijte ScriptManagerProxy ovládací prvek. Další informace naleznete v tématu Použití ovládacího prvku UpdatePanel se stránkami předlohy.
Správa a registrace skriptů
Ovládací ScriptManager prvek umožňuje registrovat skript, který se pak vykreslí jako součást stránky. Metody ScriptManager registrace ovládacích prvků je možné rozdělit do následujících tří kategorií:
Metody registrace, které zaručují, že jsou zachovány závislosti skriptů v knihovně Microsoft Ajax Library.
Metody registrace, které nejsou závislé na knihovně Microsoft Ajax Library, ale jsou kompatibilní s ovládacími UpdatePanel prvky.
Metody registrace, které podporují práci s ovládacími UpdatePanel prvky.
Další informace o tom, jak vytvořit a používat skript Ajax v ASP.NET naleznete v tématu Vytváření vlastních klientských skriptů pomocí knihovny Microsoft Ajax.
Registrace skriptu, který je závislý na knihovně Microsoft Ajax
Následující metody můžete použít k registraci souborů skriptů způsobem, který zaručuje, že jsou zachovány všechny závislosti na knihovně Microsoft Ajax Library.
| Metoda | definice |
|---|---|
| RegisterScriptControl | Zaregistruje serverový ovládací prvek, který implementuje IScriptControl rozhraní, které se používá k definování objektu klienta Sys.Component . Ovládací ScriptManager prvek vykreslí skript, který podporuje objekt klienta. |
| RegisterExtenderControl | Zaregistruje serverový ovládací prvek, který implementuje IExtenderControl rozhraní, které se používá k definování objektu klienta Sys.Component . Ovládací ScriptManager prvek vykreslí skript, který podporuje objekt klienta. |
Registrace skriptů kompatibilních s aktualizací Partial-Page
Následující metody můžete použít k registraci souborů skriptů, které nejsou závislé na knihovně Microsoft Ajax Library, ale jsou kompatibilní s ovládacími UpdatePanel prvky. Tyto metody odpovídají podobným metodám ClientScriptManager ovládacího prvku. Pokud vykreslujete skript pro použití uvnitř UpdatePanel ovládacího prvku, ujistěte se, že voláte metody ScriptManager ovládacího prvku.
| Metoda | definice |
|---|---|
| RegisterArrayDeclaration | Přidá hodnotu do pole JavaScriptu. Pokud pole neexistuje, vytvoří se. |
| RegisterClientScriptBlock | Vykreslí prvek za levou script<form> značkou stránky. Skript se zadává jako řetězcový parametr. |
| RegisterClientScriptInclude | Vykreslí prvek za levou script<form> značkou stránky. Obsah skriptu je určen nastavením atributu src na adresu URL, která odkazuje na soubor skriptu. |
| RegisterClientScriptResource | Vykreslí prvek za levou script<form> značkou stránky. Obsah skriptu se zadává s názvem prostředku v sestavení. Atribut src se automaticky naplní adresou URL voláním obslužné rutiny HTTP, která načte pojmenovaný skript ze sestavení. |
| RegisterExpandoAttribute | Vykreslí vlastní dvojici atributů name/value (expando) v kódu pro zadaný ovládací prvek. |
| RegisterHiddenField | Vykreslí skryté pole. |
| RegisterOnSubmitStatement | Zaregistruje skript, který se spustí v reakci na událost elementu formsubmit . Atribut onSubmit odkazuje na zadaný skript. |
| RegisterStartupScript | Vykreslí blok spouštěcího skriptu těsně před koncovou </form> značkou stránky. Skript, který se má vykreslit, je určen jako řetězcový parametr. |
Při registraci metod zadáte pro tento skript dvojici typu/klíče. Pokud už je skript se stejným typem nebo párem klíčů zaregistrovaný, nový skript se nezaregistruje. Podobně pokud zaregistrujete skript s dvojicí názvu typu nebo prostředku, který již existuje, prvek, který odkazuje na prostředek, script se znovu nepřidá. Když zaregistrujete rozbalení atributu dříve zaregistrovaného atributu, vyvolá se výjimka. Je povolena duplicitní registrace hodnot pole.
Když voláte metodu nebo metodu RegisterClientScriptIncludeRegisterClientScriptResource , vyhněte se registraci skriptu, který spouští vložené funkce. Místo toho zaregistrujte skript, který obsahuje definice funkcí, jako jsou obslužné rutiny událostí nebo vlastní definice tříd pro vaši aplikaci.
Metody registrace ovládacích prvků UpdatePanel
Následující metody můžete použít k přizpůsobení částečných aktualizací stránky při použití UpdatePanel ovládacích prvků.
| Metoda | definice |
|---|---|
| RegisterAsyncPostBackControl | Zaregistruje ovládací prvek jako trigger pro asynchronní postbacky. |
| RegisterDataItem | Odesílá vlastní data ovládacím prvkům během částečného vykreslování stránky. |
| RegisterDispose | Zaregistruje skript dispose pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku. Skript se spustí při UpdatePanel aktualizaci nebo odstranění ovládacího prvku. Metoda Dispose se používá pro klientské komponenty, které jsou součástí knihovny Microsoft Ajax Library a které musí uvolnit prostředky, pokud se komponenta už nepoužívá. |
| RegisterPostBackControl | Zaregistruje ovládací prvek jako trigger pro úplné zpětné odeslání. Tato metoda se používá pro ovládací prvky uvnitř UpdatePanel ovládacího prvku, který by jinak prováděl asynchronní postbacky. |
Odkazy na webové služby
Webovou službu, která se má volat z klientského skriptu, můžete zaregistrovat tak, že vytvoříte ServiceReference objekt a přidáte ji do Services kolekce ScriptManager ovládacího prvku. ASP.NET vygeneruje objekt proxy klienta pro každý ServiceReference objekt v kolekci Services . Objekty můžete do Services kolekce přidat ServiceReference programově, abyste mohli registrovat webové služby za běhu.
Další informace o přístupu k webovým službám ve skriptu naleznete v tématu Zveřejnění webových služeb klientskému skriptu v ASP.NET AJAX a volání webových služeb z klientského skriptu v ASP.NET AJAX.
Localization
Ovládací ScriptManager prvek generuje odkazy na vykreslené stránce, které odkazují na příslušné lokalizované soubory skriptů, které jsou buď soubory skriptu vložené do sestavení, nebo samostatné soubory skriptů.
EnableScriptLocalization Pokud je vlastnost nastavena na true, ScriptManager ovládací prvek načte lokalizované prostředky (například lokalizované řetězce) pro aktuální jazykovou verzi, pokud existují. Ovládací ScriptManager prvek poskytuje následující funkce pro použití lokalizovaných prostředků:
Soubory skriptu, které jsou vloženy do sestavení. Ovládací ScriptManager prvek určuje, který soubor skriptu jazykové verze nebo záložní jazykové verze se má odeslat do prohlížeče. Provede to pomocí atributu sestavení specifického pro NeutralResourcesLanguageAttribute jazykovou verzi, prostředků zabalených sestavením a jazykové verze uživatelského rozhraní prohlížeče (pokud existuje).
Samostatné soubory skriptů. Ovládací ScriptManager prvek definuje seznam jazykových verzí uživatelského rozhraní, které jsou podporovány pomocí ResourceUICultures vlastnosti objektu ScriptReference .
V režimu ladění. Ovládací ScriptManager prvek se pokusí vykreslit soubor skriptu specifický pro jazykovou verzi, který obsahuje informace o ladění. Pokud je například stránka v režimu ladění a aktuální jazyková verze je nastavená na en-MX, ovládací prvek vykreslí soubor skriptu, který má název, například
scriptname.en-MX.debug.js, pokud soubor existuje. Pokud soubor neexistuje, vykreslí se ladicí soubor pro příslušnou záložní jazykovou verzi.
Další informace o tom, jak lokalizovat prostředky, naleznete v tématu Přehled lokalizace prostředků pro knihovny komponent.
Zpracování chyb
Pokud dojde k chybě stránky během asynchronních postbacků, dojde k AsyncPostBackError vyvolání události. Způsob, jakým se chyby na serveru odesílají klientovi, závisí na AllowCustomErrorsRedirect vlastnosti, AsyncPostBackErrorMessage vlastnosti a vlastní části chyb v souboru Web.config. Další informace naleznete v tématu Přizpůsobení zpracování chyb ovládacích prvků UpdatePanel.
Deklarativní syntaxe
<asp:ScriptManager
AllowCustomErrorsRedirect="True|False"
AsyncPostBackErrorMessage="string"
AsyncPostBackTimeout="integer"
AuthenticationService-Path="uri"
EnablePageMethods="True|False"
EnablePartialRendering="True|False"
EnableScriptGlobalization="True|False"
EnableScriptLocalization="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
LoadScriptsBeforeUI="True|False"
OnAsyncPostBackError="AsyncPostBackError event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnResolveScriptReference="ResolveScriptReference event handler"
OnUnload="Unload event handler"
ProfileService-LoadProperties="string"
ProfileService-Path="uri"
RoleService-LoadRoles="True|False"
RoleService-Path="uri"
runat="server"
ScriptMode="Auto|Inherit|Debug|Release"
ScriptPath="string"
SkinID="string"
SupportsPartialRendering="True|False"
Visible="True|False"
>
<AuthenticationService
Path="uri"
/>
<ProfileService
LoadProperties="string"
Path="uri"
/>
<RoleService
LoadRoles="True|False"
Path="uri"
/>
<Scripts>
<asp:ScriptReference
Assembly="string"
IgnoreScriptPath="True|False"
Name="string"
NotifyScriptLoaded="True|False"
Path="string"
ResourceUICultures="string"
ScriptMode="Auto|Debug|Inherit|Release"
/>
</Scripts>
<Services>
<asp:ServiceReference
InlineScript="True|False"
Path="string"
/>
</Services>
</asp:ScriptManager>
Konstruktory
| Name | Description |
|---|---|
| ScriptManager() |
Inicializuje novou instanci ScriptManager třídy. |
Vlastnosti
| Name | Description |
|---|---|
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AjaxFrameworkAssembly |
Získá ajax framework sestavení, které komponenty na stránce použít. |
| AjaxFrameworkMode |
Získá nebo nastaví hodnotu, která určuje, jak budou klientské skripty klientské knihovny Microsoft Ajax zahrnuty do klienta. |
| AllowCustomErrorsRedirect |
Získá nebo nastaví hodnotu, která určuje, zda vlastní chyby oddílu Web.config soubor je použit během chyby v asynchronní postback. |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| AsyncPostBackErrorMessage |
Získá nebo nastaví chybovou zprávu, která je odeslána klientovi, když dojde k neošetřené výjimce serveru během asynchronního postbacku. |
| AsyncPostBackSourceElementID |
Získá jedinečné ID ovládacího prvku, který způsobil asynchronní postback. |
| AsyncPostBackTimeout |
Získá nebo nastaví hodnotu, která označuje čas v sekundách před vypršením časového limitu asynchronního postbacks, pokud není přijata žádná odpověď. |
| AuthenticationService |
AuthenticationServiceManager Získá objekt, který je přidružen k aktuální ScriptManager instanci. |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control) |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClientID |
Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
| ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
| ClientIDSeparator |
Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control) |
| ClientNavigateHandler |
Získá nebo nastaví název metody, která zpracovává Sys.Application.navigate událost v klientovi. |
| CompositeScript |
Získá odkaz na složený skript, který podporuje webovou stránku. |
| Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
| Controls |
ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control) |
| DataItemContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| EmptyPageUrl |
Získá nebo nastaví adresu URL na prázdnou webovou stránku. |
| EnableCdn |
Určuje, zda aktuální stránka načte odkazy na klientské skripty z cest CDN (Content Delivery Network). |
| EnableCdnFallback |
Umožňuje místní kopii skriptu, aby se načetla v případě, že síť pro doručování obsahu (CdN) není k dispozici. |
| EnableHistory |
Získá nebo nastaví hodnotu, která označuje, zda webová stránka podporuje správu bodů historie. |
| EnablePageMethods |
Získá nebo nastaví hodnotu, která označuje, zda veřejné statické stránky metody na stránce ASP.NET lze volat z klientského skriptu. |
| EnablePartialRendering |
Získá nebo nastaví hodnotu, která umožňuje částečné vykreslování stránky, což zase umožňuje aktualizovat oblasti stránky jednotlivě pomocí UpdatePanel ovládacích prvků. |
| EnableScriptGlobalization |
Získá nebo nastaví hodnotu, která určuje, zda ScriptManager ovládací prvek vykresluje skript, který podporuje parsování a formátování informací specifických pro jazykovou verzi. |
| EnableScriptLocalization |
Získá nebo nastaví hodnotu, která určuje, zda ScriptManager ovládací prvek vykresluje lokalizované verze souborů skriptu. |
| EnableSecureHistoryState |
Získá nebo nastaví hodnotu, která určuje, zda se má zašifrovat řetězec stavu historie. |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od Control) |
| EnableViewState |
Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control) |
| Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
| HasChildViewState |
Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control) |
| IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
| IsChildControlStateCleared |
Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control) |
| IsDebuggingEnabled |
Získá hodnotu, která označuje, zda ladicí verze klientských skriptových knihoven budou vykresleny. |
| IsInAsyncPostBack |
Získá hodnotu, která určuje, zda se aktuální postback spouští v režimu částečného vykreslování. |
| IsNavigating |
Získá hodnotu, která označuje, zda Navigate událost právě zpracovává. |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LoadScriptsBeforeUI |
Získá nebo nastaví hodnotu, která označuje, zda jsou skripty načteny před nebo po revize pro uživatelské rozhraní stránky je načten. |
| LoadViewStateByID |
Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| ProfileService |
ProfileServiceManager Získá objekt, který je přidružen k aktuální ScriptManager instanci. |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control) |
| RoleService |
RoleServiceManager Získá objekt, který je přidružen k aktuální ScriptManager instanci. |
| ScriptMode |
Získá nebo nastaví hodnotu, která určuje, zda jsou vykresleny ladicí nebo vydané verze klientských knihoven skriptů. |
| ScriptPath |
Zastaralé.
Získá nebo nastaví kořenovou cestu umístění, které se používá k sestavení cest pro ASP.NET Ajax a soubory vlastních skriptů. |
| ScriptResourceMapping |
ScriptResourceMapping Získá objekt. |
| Scripts |
ScriptReferenceCollection Získá objekt, který obsahuje ScriptReference objekty, z nichž každý představuje soubor skriptu vykreslený klientovi. |
| Services |
ServiceReferenceCollection Získá objekt, který obsahuje ServiceReference objekt pro každou webovou službu, která ASP.NET zpřístupňuje klienta pro funkce Ajax. |
| Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od Control) |
| SupportsPartialRendering |
Získá hodnotu, která označuje, zda klient podporuje částečné vykreslování stránky. |
| TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
| TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control) |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Visible Přepíše vlastnost zděděnou ze základní Control třídy, aby se zabránilo nastavení této hodnoty. |
Metody
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
| AddHistoryPoint(NameValueCollection, String) |
Vytvoří bod historie a přidá ho do zásobníku historie prohlížeče pomocí zadaného shromažďování dat o stavu a názvu stavu. |
| AddHistoryPoint(String, String, String) |
Vytvoří bod historie a přidá ho do zásobníku historie prohlížeče pomocí zadaného klíče stavu, hodnoty stavu a názvu stavu. |
| AddHistoryPoint(String, String) |
Vytvoří bod historie a přidá ho do zásobníku historie prohlížeče pomocí zadaného klíče stavu a hodnoty stavu. |
| AddParsedSubObject(Object) |
Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu uloženou ClientID v mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| CreateChildControls() |
Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control) |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control) |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
| DataBindChildren() |
Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control) |
| Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
| EndRenderTracing(TextWriter, Object) |
Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| Focus() |
Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control) |
| GetCurrent(Page) |
ScriptManager Získá instanci pro daný Page objekt. |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetRegisteredArrayDeclarations() |
Načte kolekci polí ECMAScript (JavaScript) jen pro čtení, které byly dříve zaregistrovány u objektu Page . |
| GetRegisteredClientScriptBlocks() |
Načte kolekci bloků klientského skriptu jen pro čtení, které byly dříve zaregistrovány v ovládacím ScriptManager prvku. |
| GetRegisteredDisposeScripts() |
Načte kolekci |
| GetRegisteredExpandoAttributes() |
Načte kolekci vlastních atributů (expando) jen pro čtení, které byly dříve zaregistrovány u objektu Page . |
| GetRegisteredHiddenFields() |
Načte kolekci skrytých polí jen pro čtení, která byla dříve zaregistrována u objektu Page . |
| GetRegisteredOnSubmitStatements() |
Načte kolekci |
| GetRegisteredStartupScripts() |
Načte kolekci spouštěcích skriptů jen pro čtení, které byly dříve zaregistrovány u objektu Page . |
| GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetStateString() |
Načte řetězec obsahující páry klíč/hodnota, které představují stav webové stránky. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control) |
| LoadPostData(String, NameValueCollection) |
Čte data formuláře, která se publikují z prohlížeče na server, a určuje zdroj asynchronního postbacku. |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozí žádosti o stránku, která byla uložena metodou SaveViewState() . (Zděděno od Control) |
| MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
AsyncPostBackError Vyvolá událost. |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control) |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnInit(EventArgs) |
Init Vyvolá událost a zajistí, že na stránce existuje pouze jeden ScriptManager ovládací prvek. |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
Vyvolá událost a zaregistruje PreRender soubory skriptů a služby pro částečné aktualizace stránky. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
ResolveCompositeScriptReference Vyvolá událost. |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
ResolveScriptReference Vyvolá událost pro každý odkaz skriptu, který je spravován ovládacím ScriptManager prvku. |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá použité ke čtení souboru. (Zděděno od Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control) |
| RaisePostBackEvent(String) |
Zpracovává událost postback vyvolanou ovládacím ScriptManager prvku a načte stav historie webové stránky. |
| RaisePostDataChangedEvent() |
Vyvolá události pro ScriptManager ovládací prvek, když publikuje zpět na server. |
| 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. |
| RegisterAsyncPostBackControl(Control) |
Zaregistruje ovládací prvek jako trigger pro asynchronní postbacky. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Zaregistruje blok klientského skriptu pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a pak přidá blok skriptu na stránku. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Zaregistruje blok klientského skriptu pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a pak přidá blok skriptu na stránku. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Zaregistruje soubor klientského skriptu pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a pak přidá odkaz na soubor skriptu na stránku. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Zaregistruje klientský skript pomocí ScriptManager ovládacího prvku pokaždé, když dojde k asynchronnímu postbacku, a pak na stránku přidá odkaz na soubor skriptu. |
| RegisterClientScriptResource(Control, Type, String) |
Zaregistruje klientský skript vložený do sestavení pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který se účastní částečného vykreslování stránky. |
| RegisterClientScriptResource(Page, Type, String) |
Zaregistruje soubor klientského skriptu, který je vložen do sestavení, s ovládacím ScriptManager prvku při každém výskytu zpětného odeslání. |
| RegisterDataItem(Control, String, Boolean) |
Odesílá vlastní data do ovládacího prvku během částečného vykreslování stránky a označuje, jestli jsou data ve formátu JSON (JavaScript Object Notation). |
| RegisterDataItem(Control, String) |
Odesílá vlastní data do ovládacího prvku během částečného vykreslování stránky. |
| RegisterDispose(Control, String) |
Zaregistruje |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Zaregistruje dvojici name/value s ScriptManager ovládacím prvek jako vlastní atribut (expando) zadaného ovládacího prvku. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Zaregistruje ovládací prvek extenderu v aktuální ScriptManager instanci. |
| RegisterHiddenField(Control, String, String) |
Zaregistruje skryté pole ovládacím ScriptManager prvku pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku. |
| RegisterHiddenField(Page, String, String) |
Zaregistruje skryté pole pomocí ScriptManager ovládacího prvku během každého asynchronního postbacku. |
| RegisterNamedClientScriptResource(Control, String) |
Zaregistruje klientský skript podle názvu prostředku, který je vložen do sestavení s ScriptManager ovládacím prvku pro použití s ovládacím prvku, který se účastní částečného vykreslování stránky. |
| RegisterNamedClientScriptResource(Page, String) |
Zaregistruje klientský skript podle názvu prostředku, který je vložen do sestavení s ScriptManager ovládacím prvku pro použití s ovládacím prvku, který se účastní částečného vykreslování stránky. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Zaregistruje kód ECMAScript (JavaScript) ovládacím ScriptManager prvku pro ovládací prvek, který se používá s ovládacím UpdatePanel prvku, který se spustí při odeslání formuláře. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Zaregistruje kód ECMAScript (JavaScript) ovládacím ScriptManager prvku pro ovládací prvek, který se používá s ovládacím UpdatePanel prvku, který se spustí při odeslání formuláře. |
| RegisterPostBackControl(Control) |
Zaregistruje ovládací prvek jako aktivační událost pro postback. Tato metoda se používá ke konfiguraci ovládacích prvků postback uvnitř UpdatePanel ovládacího prvku, který by jinak prováděl asynchronní postbacky. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Zaregistruje ovládací prvek skriptu v aktuální ScriptManager instanci. |
| RegisterScriptDescriptors(IExtenderControl) |
Volání zpět do ExtenderControl třídy k vrácení skriptů instance, které musí být vykresleny pro podporu klientského objektu, který představuje klientský ovládací prvek, komponentu nebo chování. |
| RegisterScriptDescriptors(IScriptControl) |
ScriptControl Volá třídu pro vrácení skriptů instance, které musí být vykresleny pro podporu klientského objektu, který představuje klientský ovládací prvek, komponentu nebo chování. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Zaregistruje blok spouštěcího skriptu pro ovládací prvek, který je uvnitř UpdatePanelScriptManager ovládacího prvku, a přidá blok skriptu na stránku. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Zaregistruje blok spouštěcího skriptu pro každý asynchronní postback pomocí ScriptManager ovládacího prvku a přidá blok skriptu na stránku. |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
Vykreslí ScriptManager obsah ovládacího prvku do prohlížeče pomocí zadaného HtmlTextWriter objektu. |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control) |
| ResolveAdapter() |
Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží všechny změny stavu zobrazení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SetDesignModeState(IDictionary) |
Nastaví data návrhu pro ovládací prvek. (Zděděno od Control) |
| SetFocus(Control) |
Nastaví fokus prohlížeče na zadaný ovládací prvek. |
| SetFocus(String) |
Nastaví fokus prohlížeče na ovládací prvek určený PODLE ID. |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby je bylo možné uložit do objektu StateBag ovládacího prvku serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti. (Zděděno od Control) |
Událost
| Name | Description |
|---|---|
| AsyncPostBackError |
Nastane, když dojde k chybě stránky během asynchronního postbacku. |
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| Disposed |
Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control) |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| Navigate |
Nastane, když uživatel klikne na tlačítko Zpět nebo Vpřed prohlížeče. |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| ResolveCompositeScriptReference |
Nastane, když je složený skript registrován v ovládacím ScriptManager prvku. |
| ResolveScriptReference |
Nastane, když je členem Scripts kolekce zaregistrován ovládací prvek ScriptManager . |
| Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
