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ů, vykreslování částečných stránek a generování tříd 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í Partial-Page Aktualizace
Následující příklad ukazuje, jak pomocí ScriptManager ovládacího prvku povolit částečné aktualizace stránky. V tomto příkladu CalendarDropDownList jsou ovládací prvek a uvnitř UpdatePanel ovládacího prvku. Ve výchozím nastavení je hodnota UpdateMode vlastnosti a hodnota ChildrenAsTriggers vlastnosti je true.Always Proto podřízené ovládací prvky panelu způsobit 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 zajistit vlastní zpracování chyb během částečné aktualizace stránky. Pokud při částečné aktualizaci stránky dojde k chybě, ve výchozím nastavení se zobrazí okno se zprávou JavaScriptu. Tento příklad ukazuje, jak použít vlastní zpracování chyb poskytnutím obslužné rutiny AsyncPostBackError události a nastavením AsyncPostBackErrorMessage vlastnosti v obslužné rutině události. Můžete také nastavit AllowCustomErrorsRedirect vlastnost a určit, jak se bude používat část vlastních chyb souboru Web.config, když dojde k chybě během částečné aktualizace stránky. V tomto příkladu se používá výchozí hodnota AllowCustomErrorsRedirect vlastnosti . To znamená, že pokud Web.config soubor obsahuje element customErrors , určuje tento prvek způsob zobrazení chyb. Další informace najdete v tématu customErrors – element (ASP.NET schéma nastavení).
<%@ 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 zobrazeného 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 autohodnotu . 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 najdete v tématu Postupy: Nastavení jazykové verze a jazykové verze uživatelského rozhraní pro ASP.NET globalizaci 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:
Úvod
Ovládací ScriptManager prvek je ústředním ovládacího prvku pro funkce Ajax v ASP.NET. Ovládací prvek spravuje všechny ASP.NET prostředky Ajax na stránce. To zahrnuje stahování skriptů Microsoft Ajax Library do prohlížeče a koordinaci aktualizací částečných stránek, které jsou povoleny pomocí UpdatePanel ovládacích prvků. Ovládací prvek navíc ScriptManager umožňuje provádět následující akce:
Zaregistrujte skript, který je kompatibilní s aktualizacemi částečných 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 knihovny Microsoft Ajax Library.
Určete, jestli se do prohlížeče odesílají skripty verze nebo ladění.
Poskytněte přístup k metodám webové služby ze skriptu registrací webových služeb v ovládacím ScriptManager prvku .
Poskytnutí přístupu k ASP.NET aplikačním službám ověřování, rolí a profilů z klientského skriptu registrací těchto služeb v ovládacím ScriptManager prvku.
Povolte v prohlížeči zobrazení funkcí ECMAScript (JavaScript) Date, Number a String specifické pro jazykovou verzi.
Přístup k lokalizačním prostředkům pro soubory vložených skriptů nebo k souborům samostatných skriptů ScriptReference pomocí ResourceUICultures vlastnosti ovládacího prvku.
Zaregistrovat ovládací prvky serveru, které implementují IExtenderControl rozhraní nebo IScriptControl s ScriptManager ovládacím prvku tak, aby se vykresloval skript vyžadovaný klientskými součástmi a chováním.
Vykreslování části stránky
Schopnost ASP.NET stránky podporovat vykreslování částečných stránek se řídí 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 během nebo před událostí stránky Init . Pokud se pokusíte změnit tuto vlastnost poté, co Init došlo k události stránky, InvalidOperationException vyvolá se výjimka.
Pokud je podporováno vykreslování částečné stránky, ScriptManager ovládací prvek vykreslí skript pro povolení asynchronního zpětného odeslání a částečné aktualizace stránky. Oblasti stránky, která se má aktualizovat, jsou určeny pomocí UpdatePanel ovládacích prvků. Ovládací ScriptManager prvek zpracovává asynchronní zpětná vazba a aktualizuje pouze oblasti stránky, které je třeba aktualizovat. Další informace o vykreslování částečných stránek najdete v tématu Přehled vykreslování částečné stránky. Další informace o podmínkách, které způsobují aktualizaci, naleznete v tématu UpdatePanel Přehled ovládacího prvku.
Používání ovládacího prvku ScriptManager s hlavními stránkami, uživatelskými ovládacími prvky a ostatními podřízenými komponentami
Stránka může obsahovat pouze jeden ScriptManager ovládací prvek ve své 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 už ovládací prvek má ScriptManager , použijte tento ScriptManagerProxy ovládací prvek. Další informace najdete v tématu Použití ovládacího prvku UpdatePanel se stránkami předlohy.
Správa a registrace skriptu
Ovládací ScriptManager prvek umožňuje zaregistrovat skript, který se pak vykreslí jako součást stránky. Metody ScriptManager registrace ovládacích prvků lze rozdělit do následujících tří kategorií:
Metody registrace, které zaručují zachování závislostí skriptů na 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 vytváření a používání skriptu Ajax v ASP.NET naleznete v tématu Vytvoření vlastního klientského skriptu pomocí knihovny Microsoft Ajax Library.
Registrace skriptu, který je závislý na knihovně Microsoft Ajax Library
Následující metody můžete použít k registraci souborů skriptu způsobem, který zaručuje zachování všech závislostí na knihovně Microsoft Ajax Library.
| Metoda | Definice |
|---|---|
| RegisterScriptControl | Zaregistruje ovládací prvek serveru, 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 ovládací prvek serveru, 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 částečnou aktualizací stránky
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í script prvek za počáteční <form> značkou stránky. Skript je zadaný jako řetězcový parametr. |
| RegisterClientScriptInclude | Vykreslí script prvek za počáteční <form> značkou stránky. Obsah skriptu je určen nastavením atributu src na adresu URL, která odkazuje na soubor skriptu. |
| RegisterClientScriptResource | Vykreslí script prvek za počáteční <form> značkou stránky. Obsah skriptu je zadán s názvem prostředku v sestavení. Atribut src je automaticky naplněn adresou URL voláním obslužné rutiny HTTP, která načte pojmenovaný skript ze sestavení. |
| RegisterExpandoAttribute | Vykreslí vlastní dvojici atributu název/hodnota (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 zavírací </form> značkou stránky. Skript pro vykreslení je zadaný jako řetězcový parametr. |
Při registraci metod zadáte dvojici typ/klíč pro daný skript. Pokud je již skript se stejným typem a párem klíčů zaregistrovaný, nový skript se nezaregistruje. Podobně platí, že pokud zaregistrujete skript s již existující dvojicí typu a názvu prostředku, prvek, který odkazuje na prostředek, script se znovu nepřidá. Při registraci expando atributu dříve zaregistrovaného atributu je vyvolán výjimka. Duplicitní registrace hodnot pole je povolena.
Při volání RegisterClientScriptInclude metody nebo RegisterClientScriptResource se vyhněte 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 definice vlastních tříd pro vaši aplikaci.
Metody registrace pro ovládací prvky UpdatePanel
Při použití UpdatePanel ovládacích prvků můžete použít následující metody k přizpůsobení aktualizací částečných stránek.
| Metoda | Definice |
|---|---|
| RegisterAsyncPostBackControl | Zaregistruje ovládací prvek jako trigger pro asynchronní zpětné operace. |
| RegisterDataItem | Odesílá vlastní data ovládacím prvkům během vykreslování části 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é součásti, které jsou součástí knihovny Microsoft Ajax Library a které musí uvolnit prostředky, když komponenta již není používána. |
| 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í zpětné operace. |
Odkazy na webové služby
Webovou službu, která se má volat z klientského skriptu, můžete zaregistrovat tak, že ServiceReference vytvoříte objekt a přidáte ho ScriptManager do Services kolekce ovládacího prvku. ASP.NET vygeneruje objekt proxy klienta pro každý ServiceReference objekt v kolekci Services . Do kolekce můžete programově přidat ServiceReference objekty Services pro registraci webových služeb za běhu.
Další informace o přístupu k webovým službám ve skriptu naleznete v tématech Vystavení webových služeb pro klientský skript v ASP.NET AJAX a Volání webových služeb z klientského skriptu v ASP.NET AJAX.
Lokalizace
Ovládací ScriptManager prvek generuje odkazy na vykreslené stránce, které odkazují na příslušné soubory lokalizovaných skriptů, což jsou buď soubory skriptů vložené do sestavení, nebo samostatné soubory skriptu.
EnableScriptLocalization Pokud je vlastnost nastavena na truehodnotu , 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 skriptů, které jsou vloženy v sestavení. Ovládací ScriptManager prvek určuje, který soubor skriptu specifické pro jazykovou verzi nebo záložní jazykovou verzi se má odeslat do prohlížeče. Provádí to pomocí atributu sestavení specifického pro jazykovou NeutralResourcesLanguageAttribute verzi, prostředků zabalených se sestavením a jazykové verze uživatelského rozhraní prohlížeče (pokud existuje).
Soubory samostatných 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 nastavena 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, najdete v tématu Lokalizace prostředků pro knihovny komponent – přehled.
Zpracování chyb
Pokud dojde k chybě stránky během asynchronního AsyncPostBackError postbacku, událost je vyvolána. Způsob, jakým se chyby na serveru odesílají klientovi, závisí na AllowCustomErrorsRedirect vlastnosti, AsyncPostBackErrorMessage vlastnosti a části vlastních chyb Web.config souboru. Další informace najdete v tématu Přizpůsobení zpracování chyb pro ovládací prvky 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
| ScriptManager() |
Inicializuje novou instanci ScriptManager třídy . |
Vlastnosti
| Adapter |
Získá adaptér specifické pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AjaxFrameworkAssembly |
Získá ajax rozhraní sestavení, které součásti na stránce použít. |
| AjaxFrameworkMode |
Získá nebo nastaví hodnotu, která určuje, jak klientské skripty klientské knihovny Microsoft Ajax budou zahrnuty v klientovi. |
| AllowCustomErrorsRedirect |
Získá nebo nastaví hodnotu, která určuje, zda vlastní chyby oddíl Web.config souboru je použit během chyby v asynchronní postback. |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, 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í postback. |
| 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 zpětného odeslání, 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 datové vazby 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 serverového ovládacího prvku. (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í znak oddělovače 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ý serverový ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control) |
| DataItemContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit 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 načtení místní kopie skriptu v případě, že cdn (Content Delivery Network) není k dispozici. |
| EnableHistory |
Získá nebo nastaví hodnotu, která označuje, zda webová stránka podporuje správu bodu historie. |
| EnablePageMethods |
Získá nebo nastaví hodnotu, která označuje, zda veřejné statické metody stránky v ASP.NET stránku 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á označ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á označuje, zda ScriptManager ovládací prvek vykreslí lokalizované verze souborů skriptu. |
| EnableSecureHistoryState |
Získá nebo nastaví hodnotu, která označuje, zda se má šifrovat řetězec stavu historie. |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od Control) |
| EnableViewState |
Získá nebo nastaví hodnotu označ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 označující, zda podřízené ovládací prvky aktuálního serveru mají nějaké uložené nastavení stavu zobrazení. (Zděděno od Control) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený k 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 označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control) |
| IsDebuggingEnabled |
Získá hodnotu, která označuje, zda ladicí verze knihoven klientských skriptů budou vykresleny. |
| IsInAsyncPostBack |
Získá hodnotu, která označuje, zda aktuální postback je provedena v režimu částečného vykreslování. |
| IsNavigating |
Získá hodnotu, která označuje, zda Navigate je událost právě zpracována. |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek. (Zděděno od Control) |
| LoadScriptsBeforeUI |
Získá nebo nastaví hodnotu, která označuje, zda jsou skripty načteny před nebo po načtení kódu uživatelského rozhraní stránky. |
| LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na názvový kontejner serverového ovládacího prvku, který vytvoří jedinečný obor názvů pro odlizení mezi ovládacími prvky serveru 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 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 verze, která vykreslovala 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 knihoven klientských skriptů. |
| ScriptPath |
Zastaralé.
Získá nebo nastaví kořenovou cestu umístění, které se používá k sestavení cest k 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 zveřejňuje na klientovi 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í vzhled pro použití ovládacího prvku. (Zděděno od Control) |
| SupportsPartialRendering |
Získá hodnotu, která označuje, zda klient podporuje vykreslování částeč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í serverový ovládací prvek. (Zděděno od Control) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control) |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která označ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í serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Visible Přepíše vlastnost, která je zděděna ze základní Control třídy, aby se zabránilo nastavení této hodnoty. |
Metody
| 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 názvu shromažďování dat stavu a 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. |
| 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. |
| AddParsedSubObject(Object) |
Upozorní ovládací prvek serveru, že byl analyzován element XML nebo HTML, a přidá element do objektu serverového ControlCollection ovládacího prvku. (Zděděno od Control) |
| ApplyStyleSheetSkin(Page) |
Použije na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování vykreslovaných dat v době návrhu. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromáždí informace o serverovém ovládacím prvku a předá je vlastnosti Trace , která se má zobrazit, když je pro stránku povoleno trasování. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| CreateChildControls() |
Volána rozhraním ASP.NET stránky k upozornění serverových ovládacích prvků, které používají implementaci založenou na složení k vytvoření všech podřízených ovládacích prvků, které obsahují při přípravě na zaúčtování zpět nebo vykreslení. (Zděděno od Control) |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control) |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru 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 na podřízené ovládací prvky 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í doby návrhu vykreslovaných dat. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda serverový ovládací prvek 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čí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String) |
Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným |
| FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
| Focus() |
Nastaví fokus vstupu 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í hashovací funkce. (Zděděno od Object) |
| GetRegisteredArrayDeclarations() |
Načte kolekci ECMAScript (JavaScript) deklarace pole jen pro čtení, které byly dříve registrovány s objektem Page . |
| GetRegisteredClientScriptBlocks() |
Načte kolekci bloků klientských skriptů, které byly dříve zaregistrovány pomocí ovládacího prvku jen pro ScriptManager čtení. |
| GetRegisteredDisposeScripts() |
Načte kolekci |
| GetRegisteredExpandoAttributes() |
Načte kolekci vlastních atributů (expando) jen pro čtení, které byly dříve zaregistrovány s objektem Page . |
| GetRegisteredHiddenFields() |
Načte kolekci skrytých polí jen pro čtení, která byla dříve zaregistrována s objektem Page . |
| GetRegisteredOnSubmitStatements() |
Načte kolekci |
| GetRegisteredStartupScripts() |
Načte kolekci spouštěcích skriptů jen pro čtení, které byly dříve zaregistrovány s objektem 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ázev trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
| GetStateString() |
Načte řetězec, který obsahuje páry klíč/hodnota, které představují stav webové stránky. |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí část UniqueID vlastnosti zadaného ovládacího prvku s předponou. (Zděděno od Control) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu označ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 serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control) |
| LoadPostData(String, NameValueCollection) |
Čte data formuláře, která jsou odeslána z prohlížeče na server, a určuje zdroj asynchronního postbacku. |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku stránky, který byl uložen 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 Objectsouboru . (Zděděno od Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
AsyncPostBackError Vyvolá událost. |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost serverového ovládacího prvku předána hierarchii serveru 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) |
PreRender Vyvolá událost a zaregistruje 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 na skript, 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žívá 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ímu prvku. (Zděděno od Control) |
| RaisePostBackEvent(String) |
Zpracuje událost postback vyvolanou ovládacím ScriptManager prvek a načte stav historie webové stránky. |
| RaisePostDataChangedEvent() |
Vyvolá události pro ScriptManager ovládací prvek při odeslání zpět na server. |
| RegisterArrayDeclaration(Control, String, String) |
Zaregistruje deklaraci pole ECMAScript (JavaScript) s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku. |
| RegisterArrayDeclaration(Page, String, String) |
Zaregistruje deklaraci pole ECMAScript (JavaScript) s ovládacím ScriptManager prvku pro použití s ovládacím prvek, 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í zpětné operace. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Zaregistruje blok klientského skriptu s ovládacím ScriptManager prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a poté přidá blok skriptu na stránku. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Zaregistruje blok klientského skriptu s ovládacím ScriptManager prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a poté přidá blok skriptu na stránku. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Zaregistruje soubor klientského skriptu s ovládacím ScriptManager prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a poté přidá odkaz na soubor skriptu na stránku. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Zaregistruje klientský skript s ovládacím ScriptManager prvku pokaždé, když dojde k asynchronnímu zpětnému odeslání, a poté přidá odkaz na soubor skriptu na stránku. |
| RegisterClientScriptResource(Control, Type, String) |
Registruje klientský skript, který je vložen v sestavení s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který se účastní vykreslování částečné stránky. |
| RegisterClientScriptResource(Page, Type, String) |
Zaregistruje soubor klientského skriptu, který je vložen v sestavení s ovládacím ScriptManager prvku při každém výskytu zpětného odeslání. |
| RegisterDataItem(Control, String) |
Odesílá vlastní data do ovládacího prvku během vykreslování části stránky. |
| RegisterDataItem(Control, String, Boolean) |
Odesílá vlastní data do ovládacího prvku během vykreslování částečné stránky a určuje, jestli jsou data ve formátu JSON (JavaScript Object Notation). |
| RegisterDispose(Control, String) |
Zaregistruje |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Zaregistruje dvojici název/hodnota s ovládacím ScriptManager prvku jako vlastní atribut (expando) zadaného ovládacího prvku. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Zaregistruje rozšiřující ovládací prvek s aktuální ScriptManager instancí. |
| RegisterHiddenField(Control, String, String) |
Zaregistruje skryté pole s ovládacím ScriptManager prvku, který je uvnitř UpdatePanel ovládacího prvku. |
| RegisterHiddenField(Page, String, String) |
Registruje skryté pole s ovládacím ScriptManager prvku během každého asynchronního postback. |
| RegisterNamedClientScriptResource(Control, String) |
Registruje klientský skript podle názvu prostředku, který je vložen v sestavení s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který se účastní vykreslování částečné stránky. |
| RegisterNamedClientScriptResource(Page, String) |
Registruje klientský skript podle názvu prostředku, který je vložen v sestavení s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který se účastní vykreslování částečné stránky. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Registruje kód ECMAScript (JavaScript) s ovládacím ScriptManager prvku, který se používá s ovládacím UpdatePanel prvek, který se spustí při odeslání formuláře. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Registruje kód ECMAScript (JavaScript) s ovládacím ScriptManager prvku, který se používá s ovládacím UpdatePanel prvek, který se spustí při odeslání formuláře. |
| RegisterPostBackControl(Control) |
Zaregistruje ovládací prvek jako aktivační událost pro zpětné odeslání. Tato metoda se používá ke konfiguraci postback ovládacích prvků uvnitř UpdatePanel ovládacího prvku, který by jinak prováděl asynchronní postbacks. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Zaregistruje ovládací prvek skriptu s aktuální ScriptManager instancí. |
| RegisterScriptDescriptors(IExtenderControl) |
Volá zpět do ExtenderControl třídy pro vrácení skriptů instance, které musí být vykresleny pro podporu objektu klienta, který představuje klientský ovládací prvek, součást nebo chování. |
| RegisterScriptDescriptors(IScriptControl) |
ScriptControl Volá třídu pro vrácení skriptů instance, které musí být vykresleny pro podporu objektu klienta, 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ř objektu UpdatePanel pomocí ScriptManager 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í zpětné odeslání 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 serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit na klientovi. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (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 lze použít v prohlížeči. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží všechny změny stavu zobrazení ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SetDesignModeState(IDictionary) |
Nastaví data v době návrhu ovládacího prvku. (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ý pomocí ID. |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události pro vykreslení serverového ovládacího prvku a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí datového klíče trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče 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 mohly být uloženy v objektu ovládacího prvku StateBag serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti . (Zděděno od Control) |
Událost
| AsyncPostBackError |
Nastane, když dojde k chybě stránky během asynchronního postback. |
| DataBinding |
Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat. (Zděděno od Control) |
| Disposed |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována ASP.NET stránka. (Zděděno od Control) |
| Init |
Vyvolá se při inicializaci serverového ovládacího prvku, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Vyvolá se při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control) |
| Navigate |
Vyvolá se, když uživatel klikne na tlačítko Zpět nebo Vpřed v prohlížeči. |
| PreRender |
Vyvolá se po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| ResolveCompositeScriptReference |
Vyvolá se při registraci složeného skriptu v ovládacím ScriptManager prvku. |
| ResolveScriptReference |
Vyvolá se při registraci člena Scripts kolekce pomocí ScriptManager ovládacího prvku . |
| Unload |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
| 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 názvů zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro