ScriptManager Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Kezeli ASP.NET Ajax-szkripttárakat és szkriptfájlokat, részleges oldalmegjelenítést és ügyfélproxy-osztály létrehozását a web- és alkalmazásszolgáltatásokhoz.
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 IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
- Öröklődés
- Attribútumok
- Megvalósítás
Példák
Az alábbi példák különböző forgatókönyveket mutatnak be a ScriptManager vezérlőelem használatához.
Partial-Page frissítések engedélyezése
Az alábbi példa bemutatja, hogyan engedélyezheti a részleges oldalfrissítéseket a ScriptManager vezérlő használatával. Ebben a példában egy Calendar és egy DropDownList vezérlő található egy UpdatePanel vezérlőn belül. Alapértelmezés szerint a UpdateMode tulajdonság Alwaysértéke , a tulajdonság ChildrenAsTriggersértéke pedig .true Ezért a panel gyermekvezérlői aszinkron visszavételt okoznak.
<%@ 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>
A Partial-Page frissítési hibáinak kezelése és a szkript regisztrálása
Az alábbi példa bemutatja, hogyan biztosíthatja az egyéni hibakezelést a részleges oldalfrissítések során. Ha a részleges oldalfrissítések során hiba történik, alapértelmezés szerint egy JavaScript-üzenetmező jelenik meg. Ez a példa bemutatja, hogyan használható az egyéni hibakezelés az esemény kezelőjének AsyncPostBackError megadásával és az AsyncPostBackErrorMessage eseménykezelő tulajdonságának beállításával. A tulajdonságot úgy is beállíthatja AllowCustomErrorsRedirect , hogy adja meg, hogyan használja a Web.config fájl egyéni hibaszakaszát, ha hiba történik a részleges oldalfrissítések során. Ebben a példában a tulajdonság alapértelmezett értékét használja a AllowCustomErrorsRedirect rendszer. Ez azt jelenti, hogy ha a Web.config fájl tartalmaz egy customErrors elemet, az az elem határozza meg a hibák megjelenítését. További információ: customErrors elem (ASP.NET Beállítások séma).
<%@ 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>
A böngészőben megjelenített dátum és idő globalizálása
Az alábbi példa bemutatja, hogyan állíthatja be a tulajdonságot, hogy az EnableScriptGlobalization ügyfélszkript megjeleníthesse a kultúraspecifikus dátumot és időt a böngészőben. A példában a Culture@Page direktíva attribútuma a következőre autovan állítva: . Ennek eredményeképpen az aktuális böngészőbeállításokban megadott első nyelv határozza meg a lap kulturális és felhasználói felületi kultúráját. További információ: Hogyan is: A kulturális és felhasználói felületi kultúra beállítása ASP.NET weblap globalizációjához.
<%@ 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>
Megjegyzések
Ebben a témakörben:
Bevezetés
A ScriptManager vezérlő központi szerepet nyújt az Ajax funkcióiban ASP.NET. A vezérlő az összes ASP.NET Ajax-erőforrást kezeli egy lapon. Ez magában foglalja Microsoft Ajax Library-szkriptek letöltését a böngészőbe, valamint a UpdatePanel vezérlők használatával engedélyezett részleges oldalfrissítések koordinálását. A vezérlő emellett a ScriptManager következőket is lehetővé teszi:
Részleges oldalfrissítésekkel kompatibilis szkript regisztrálása. A szkript és az alaptár közötti függőségek kezelése érdekében a regisztrált szkriptek az Ajax-kódtár Microsoft után töltődnek be.
Adja meg, hogy a rendszer elküldi-e a kiadási vagy hibakeresési szkripteket a böngészőnek.
Adjon hozzáférést a webszolgáltatás-metódusokhoz szkriptből, ha webszolgáltatásokat regisztrál a ScriptManager vezérlővel.
Hozzáférést biztosíthat ASP.NET hitelesítési, szerepkör- és profilalkalmazás-szolgáltatásokhoz az ügyfélszkriptből úgy, hogy regisztrálja ezeket a szolgáltatásokat a ScriptManager vezérlővel.
Engedélyezze az ECMAScript (JavaScript) dátum-, szám- és sztringfüggvényeinek kultúraspecifikus megjelenítését a böngészőben.
A vezérlő tulajdonságának ResourceUICultures használatával ScriptReference hozzáférhet a honosítási erőforrásokhoz beágyazott szkriptfájlokhoz vagy különálló szkriptfájlokhoz.
Regisztrálja azokat a kiszolgálóvezérlőket, amelyek a vezérlővel implementálják azokat IExtenderControl , IScriptControl hogy az ScriptManager ügyfélösszetevők és -viselkedések által megkövetelt szkriptek renderelhetők.
Partial-Page renderelés
Egy ASP.NET lap részleges renderelésének támogatásához a következő tényezők vezérlik:
A ScriptManager vezérlő tulajdonságának EnablePartialRendering (az alapértelmezett értéknek) kell lennie
true.Legalább egy UpdatePanel vezérlőelemnek kell lennie az oldalon.
A SupportsPartialRendering tulajdonságnak (az alapértelmezett értéknek) kell lennie
true. Ha a SupportsPartialRendering tulajdonság nincs explicit módon beállítva, az értéke a böngésző képességein alapul.
A tulajdonság értékét felülbírálhatja futtatáskor EnablePartialRendering a lap eseménye Init alatt vagy előtt. Ha a tulajdonságot a lap eseménye Init után próbálja módosítani, a rendszer kivételt InvalidOperationException jelez.
Ha a részleges oldalmegjelenítés támogatott, a vezérlő rendereli a ScriptManager szkriptet az aszinkron utómunkák és a részleges oldalfrissítések engedélyezéséhez. A frissítendő lap régiói vezérlőkkel vannak kijelölve UpdatePanel . A ScriptManager vezérlő kezeli az aszinkron visszavételeket, és csak a frissíteni kívánt lapterületeket frissíti. A részleges oldalmegjelenítésről további információt Partial-Page Renderelés áttekintése című témakörben talál. A frissítést kiváltó feltételekről további információt az UpdatePanel vezérlő áttekintése című témakörben talál.
A ScriptManager vezérlő használata mesterlapokkal, felhasználói vezérlőkkel és egyéb gyermekösszetevőkkel
Egy lap csak egy ScriptManager vezérlőt tartalmazhat a hierarchiájában. Ha szolgáltatásokat és szkripteket szeretne regisztrálni beágyazott lapokhoz, felhasználói vezérlőkhöz vagy összetevőkhöz, ha a szülőlap már rendelkezik ScriptManager vezérlővel, használja a vezérlőt ScriptManagerProxy . További információ: Az UpdatePanel vezérlő használata mesterlapokkal.
Szkriptkezelés és -regisztráció
A ScriptManager vezérlő lehetővé teszi a lap részeként renderelt szkriptek regisztrálását. A ScriptManager vezérlőregisztrációs módszerek a következő három kategóriába sorolhatók:
Olyan regisztrációs módszerek, amelyek garantálják az Ajax-kódtár Microsoft szkriptfüggőségeinek fenntartását.
Olyan regisztrációs módszerek, amelyek nem függnek az Ajax-kódtár Microsoft, de kompatibilisek UpdatePanel vezérlőkkel.
A vezérlők használatát UpdatePanel támogató regisztrációs módszerek.
Az Ajax-szkriptek ASP.NET való létrehozásáról és használatáról további információt az Ajax-kódtár Microsoft egyéni ügyfélszkriptjének létrehozásával című témakörben talál.
Az Ajax Microsoft-kódtártól függő szkript regisztrálása
Az alábbi módszerekkel olyan módon regisztrálhatja a szkriptfájlokat, hogy az garantálja az Ajax-kódtár Microsoft függőségeinek fenntartását.
| Módszer | Definition |
|---|---|
| RegisterScriptControl | Regisztrál egy kiszolgálóvezérlőt, amely implementálja a IScriptControlSys.Component ügyfélobjektum meghatározásához használt felületet. A ScriptManager vezérlő rendereli az ügyfélobjektumot támogató szkriptet. |
| RegisterExtenderControl | Regisztrál egy kiszolgálóvezérlőt, amely implementálja a IExtenderControlSys.Component ügyfélobjektum meghatározásához használt felületet. A ScriptManager vezérlő rendereli az ügyfélobjektumot támogató szkriptet. |
Partial-Page Frissítéskompatibilis szkriptek regisztrálása
Az alábbi módszerekkel regisztrálhat olyan szkriptfájlokat, amelyek nem függnek az Microsoft Ajax-kódtártól, de kompatibilisek UpdatePanel vezérlőkkel. Ezek a módszerek a vezérlő hasonló módszereinek ClientScriptManager felelnek meg. Ha parancsprogramot jelenít meg egy UpdatePanel vezérlőben való használatra, győződjön meg arról, hogy meghívja a ScriptManager vezérlő metódusait.
| Módszer | Definition |
|---|---|
| RegisterArrayDeclaration | Értéket ad hozzá Egy JavaScript-tömbhöz. Ha a tömb nem létezik, létrejön. |
| RegisterClientScriptBlock | A lap nyitó script címkéje után megjelenít egy <form> elemet. A szkript sztringparaméterként van megadva. |
| RegisterClientScriptInclude | A lap nyitó script címkéje után megjelenít egy <form> elemet. A szkript tartalma úgy van megadva, hogy az src attribútumot egy szkriptfájlra mutató URL-címre állítja. |
| RegisterClientScriptResource | A lap nyitó script címkéje után megjelenít egy <form> elemet. A szkript tartalma erőforrásnévvel van megadva egy szerelvényben. Az src attribútumot egy HTTP-kezelő hívása automatikusan feltölti EGY URL-címmel, amely lekéri az elnevezett szkriptet a szerelvényből. |
| RegisterExpandoAttribute | Egy egyéni név-érték attribútumpárt (egy expandót) jelenít meg egy adott vezérlőelem jelölőjében. |
| RegisterHiddenField | Rejtett mező megjelenítése. |
| RegisterOnSubmitStatement | Regisztrál egy szkriptet, amelyet az form elem eseményére submit válaszul hajtanak végre. Az onSubmit attribútum a megadott szkriptre hivatkozik. |
| RegisterStartupScript | Az indítási szkriptblokkot a lap záró </form> címkéje előtt jeleníti meg. A renderelendő szkript sztringparaméterként van megadva. |
Metódusok regisztrálásakor meg kell adnia egy típus-kulcspárt a szkripthez. Ha egy azonos típusú/kulcspárt tartalmazó szkript már regisztrálva van, a rendszer nem regisztrál egy új szkriptet. Hasonlóképpen, ha már létező típus-/erőforrásnév-párral regisztrál egy szkriptet, a rendszer nem adja hozzá újra az script erőforrásra hivatkozó elemet. Ha egy korábban regisztrált attribútum expando attribútumát regisztrálja, a rendszer kivételt jelez. A tömbértékek duplikált regisztrálása engedélyezett.
Amikor meghívja a RegisterClientScriptInclude metódust, kerülje a RegisterClientScriptResource beágyazott függvényeket végrehajtó szkript regisztrálását. Ehelyett regisztráljon olyan szkriptet, amely olyan függvénydefiníciókat tartalmaz, mint az eseménykezelők vagy az alkalmazás egyéni osztálydefiníciói.
Az UpdatePanel-vezérlők regisztrációs módszerei
A vezérlők használatakor UpdatePanel a következő módszerekkel testre szabhatja a részleges oldalfrissítéseket.
| Módszer | Definition |
|---|---|
| RegisterAsyncPostBackControl | Egy vezérlőt regisztrál eseményindítóként az aszinkron visszavételekhez. |
| RegisterDataItem | Egyéni adatokat küld a vezérlőknek a részleges oldalmegjelenítés során. |
| RegisterDispose | Egy vezérlőn belül található vezérlőkhöz regisztrál egy megsemmisítő szkriptet UpdatePanel . A szkript a vezérlő frissítésekor vagy törlésekor UpdatePanel lesz végrehajtva. Az elidegenítési módszer olyan ügyfélösszetevőkhöz használatos, amelyek az Ajax-kódtár Microsoft részét képezik, és amelyeknek erőforrásokat kell felszabadítania, ha már nem használnak összetevőt. |
| RegisterPostBackControl | Egy vezérlőt regisztrál eseményindítóként a teljes visszavételhez. Ez a módszer olyan vezérlők vezérlőihez UpdatePanel használható, amelyek egyébként aszinkron utómunkát hajtanak végre. |
Webszolgáltatás-hivatkozások
Az ügyfélszkriptből meghívandó webszolgáltatást regisztrálhatja úgy, hogy létrehoz egy ServiceReference objektumot, és hozzáadja a ServicesScriptManager vezérlő gyűjteményéhez. ASP.NET létrehoz egy ügyfélproxy-objektumot a ServiceReference gyűjtemény minden egyes Services objektumához. A webszolgáltatások futásidőben történő regisztrálásához programozott módon hozzáadhat ServiceReference objektumokat a Services gyűjteményhez.
További információ a webszolgáltatások parancsfájlban való eléréséről: A webszolgáltatások ügyfélszkriptje az ASP.NET AJAX és A webszolgáltatások hívása ügyfélszkriptből ASP.NET AJAX.
Lokalizáció
A ScriptManager vezérlő olyan hivatkozásokat hoz létre a renderelt lapon, amelyek a megfelelő honosított szkriptfájlokra mutatnak, amelyek vagy szerelvényekbe ágyazott szkriptfájlok, vagy különálló szkriptfájlok.
A tulajdonság beállításakor EnableScriptLocalizationa true vezérlőelem lekéri az ScriptManager aktuális kultúrához tartozó honosított erőforrásokat (például honosított sztringeket), ha léteznek. A ScriptManager vezérlő a következő funkciókat biztosítja a honosított erőforrások használatához:
Szerelvénybe beágyazott szkriptfájlok. A ScriptManager vezérlő határozza meg, hogy melyik kultúraspecifikus vagy tartalék kultúra szkriptfájlt küldje el a böngészőnek. Ehhez használja a kultúraspecifikus NeutralResourcesLanguageAttribute szerelvény attribútumot, a szerelvényhez csomagolt erőforrásokat és a böngésző felhasználói felületi kultúráját (ha van ilyen).
Különálló szkriptfájlok. A ScriptManager vezérlő meghatározza az objektum tulajdonságával ResourceUICulturesScriptReference támogatott felhasználói felületi kultúrák listáját.
Hibakeresési módban. A ScriptManager vezérlő megpróbál megjeleníteni egy kultúraspecifikus szkriptfájlt, amely hibakeresési információkat tartalmaz. Ha például a lap hibakeresési módban van, és az aktuális kultúra en-MXvan beállítva, a vezérlő egy olyan szkriptfájlt jelenít meg, amelynek neve például
scriptname.en-MX.debug.js, ha a fájl létezik. Ha a fájl nem létezik, a rendszer megjeleníti a megfelelő tartalék kultúrához tartozó hibakeresési fájlt
Az erőforrások honosításával kapcsolatos további információkért lásd: Erőforrások honosítása összetevőtárakhoz – áttekintés.
Hibakezelés
Ha az aszinkron utómunkák során laphiba lép fel, az AsyncPostBackError esemény létre lesz hozva. A kiszolgáló hibáinak az ügyfélnek való elküldésének módja a AllowCustomErrorsRedirect tulajdonságtól, a AsyncPostBackErrorMessage tulajdonságtól és a Web.config fájl egyéni hibák szakaszától függ. További információ: Az UpdatePanel-vezérlők hibakezelésének testreszabása.
Deklaratív szintaxis
<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>
Konstruktorok
| Name | Description |
|---|---|
| ScriptManager() |
Inicializálja a ScriptManager osztály új példányát. |
Tulajdonságok
| Name | Description |
|---|---|
| Adapter |
Lekéri a vezérlő böngészőspecifikus adapterét. (Öröklődés forrása Control) |
| AjaxFrameworkAssembly |
Lekéri a lap összetevői által használt Ajax-keretrendszer-szerelvényt. |
| AjaxFrameworkMode |
Lekéri vagy beállít egy értéket, amely meghatározza, hogy az Ajax-ügyfélkódtár Microsoft ügyfélszkriptjei hogyan legyenek belefoglalva az ügyfélbe. |
| AllowCustomErrorsRedirect |
Lekéri vagy beállít egy értéket, amely meghatározza, hogy a Web.config fájl egyéni hibaszakasza használható-e az aszinkron utómunkák során. |
| AppRelativeTemplateSourceDirectory |
Lekéri vagy beállítja a vezérlőt tartalmazó objektum Page alkalmazás-relatív virtuális könyvtárátUserControl. (Öröklődés forrása Control) |
| AsyncPostBackErrorMessage |
Lekéri vagy beállítja az ügyfélnek küldött hibaüzenetet, ha egy aszinkron visszavétel során nem kezelt kiszolgálói kivétel lép fel. |
| AsyncPostBackSourceElementID |
Lekéri annak a vezérlőnek az egyedi azonosítóját, amely az aszinkron visszavételt okozta. |
| AsyncPostBackTimeout |
Lekéri vagy beállít egy értéket, amely másodpercek alatt jelzi az aszinkron postbackek időtúllépését, ha nem érkezik válasz. |
| AuthenticationService |
Lekéri az AuthenticationServiceManager aktuális ScriptManager példányhoz társított objektumot. |
| BindingContainer |
Lekéri a vezérlő adatkötését tartalmazó vezérlőt. (Öröklődés forrása Control) |
| ChildControlsCreated |
Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő gyermekvezérlői létrejöttek-e. (Öröklődés forrása Control) |
| ClientID |
Lekéri a ASP.NET által létrehozott HTML-korrektúra vezérlőazonosítóját. (Öröklődés forrása Control) |
| ClientIDMode |
Lekéri vagy beállítja a tulajdonság értékének létrehozásához használt algoritmust ClientID . (Öröklődés forrása Control) |
| ClientIDSeparator |
Beolvas egy karakterértéket, amely a tulajdonságban használt elválasztó karaktert ClientID jelöli. (Öröklődés forrása Control) |
| ClientNavigateHandler |
Lekéri vagy beállítja annak a metódusnak a nevét, amely kezeli a Sys.Application.navigate eseményt az ügyfélen. |
| CompositeScript |
A weblapot támogató összetett szkriptre mutató hivatkozást kap. |
| Context |
Lekéri az HttpContext aktuális webkérelem kiszolgálóvezérlőjével társított objektumot. (Öröklődés forrása Control) |
| Controls |
ControlCollection Lekéri az objektumot, amely egy adott kiszolgálóvezérlő gyermekvezérlőit jelöli a felhasználói felületi hierarchiában. (Öröklődés forrása Control) |
| DataItemContainer |
Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataItemContainer. (Öröklődés forrása Control) |
| DataKeysContainer |
Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataKeysControl. (Öröklődés forrása Control) |
| DesignMode |
Lekéri az értéket, amely jelzi, hogy egy vezérlőt használ-e a tervezőfelületen. (Öröklődés forrása Control) |
| EmptyPageUrl |
Lekéri vagy beállítja az URL-címet egy üres weblapra. |
| EnableCdn |
Meghatározza, hogy az aktuális oldal betölti-e az ügyfélszkript-hivatkozásokat a CDN (Content Delivery Network) elérési útjaiból. |
| EnableCdnFallback |
Lehetővé teszi egy szkript helyi másolatának betöltését abban az esetben, ha a CDN (Content Delivery Network) nem érhető el. |
| EnableHistory |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a weblap támogatja-e az előzménypont-kezelést. |
| EnablePageMethods |
Lekéri vagy beállít egy értéket, amely jelzi, hogy egy ASP.NET lapon lévő nyilvános statikus lap metódusai meghívhatók-e ügyfélszkriptből. |
| EnablePartialRendering |
Lekéri vagy beállít egy olyan értéket, amely lehetővé teszi egy oldal részleges renderelését, ami lehetővé teszi a lap régióinak külön-külön történő frissítését vezérlők használatával UpdatePanel . |
| EnableScriptGlobalization |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a ScriptManager vezérlő olyan szkriptet jelenít-e meg, amely támogatja a kultúraspecifikus információk elemzését és formázását. |
| EnableScriptLocalization |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő megjeleníti-e a ScriptManager szkriptfájlok honosított verzióit. |
| EnableSecureHistoryState |
Lekéri vagy beállít egy értéket, amely jelzi, hogy titkosítja-e az előzményállapot-sztringet. |
| EnableTheming |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a témák vonatkoznak-e erre a vezérlőre. (Öröklődés forrása Control) |
| EnableViewState |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a kiszolgálóvezérlő megőrzi-e a nézetállapotát, és hogy a gyermekvezérlők nézetállapota megmarad-e a kérést kérő ügyfélnek. (Öröklődés forrása Control) |
| Events |
Lekéri a vezérlő eseménykezelő delegáltjainak listáját. Ez a tulajdonság írásvédett. (Öröklődés forrása Control) |
| HasChildViewState |
Beolvas egy értéket, amely jelzi, hogy az aktuális kiszolgálóvezérlő gyermekvezérlői rendelkeznek-e mentett nézetállapot-beállításokkal. (Öröklődés forrása Control) |
| ID |
Lekéri vagy beállítja a kiszolgálóvezérlőhöz rendelt programozott azonosítót. (Öröklődés forrása Control) |
| IdSeparator |
Lekéri a vezérlőazonosítók elválasztásához használt karaktert. (Öröklődés forrása Control) |
| IsChildControlStateCleared |
Beolvas egy értéket, amely jelzi, hogy a vezérlőben található vezérlők rendelkeznek-e vezérlőállapotmal. (Öröklődés forrása Control) |
| IsDebuggingEnabled |
Olyan értéket kap, amely jelzi, hogy az ügyfélszkript-kódtárak hibakeresési verziói renderelve lesznek-e. |
| IsInAsyncPostBack |
Olyan értéket kap, amely jelzi, hogy az aktuális visszavétel részleges renderelési módban van-e végrehajtva. |
| IsNavigating |
Beolvas egy értéket, amely jelzi, hogy egy esemény kezelése folyamatban van-e Navigate . |
| IsTrackingViewState |
Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő menti-e a nézetállapot módosításait. (Öröklődés forrása Control) |
| IsViewStateEnabled |
Beolvas egy értéket, amely jelzi, hogy a nézet állapota engedélyezve van-e ehhez a vezérlőelemhez. (Öröklődés forrása Control) |
| LoadScriptsBeforeUI |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a szkriptek betöltve vannak-e az oldal felhasználói felületének korrektúrái előtt vagy után. |
| LoadViewStateByID |
Beolvas egy értéket, amely jelzi, hogy a vezérlő részt vesz-e a nézet állapotának index helyett való ID betöltésében. (Öröklődés forrása Control) |
| NamingContainer |
Lekéri a kiszolgálóvezérlő elnevezési tárolójára mutató hivatkozást, amely egyedi névteret hoz létre az azonos ID tulajdonságértékkel rendelkező kiszolgálóvezérlők megkülönböztetéséhez. (Öröklődés forrása Control) |
| Page |
A kiszolgálóvezérlőt tartalmazó példányra Page mutató hivatkozást kap. (Öröklődés forrása Control) |
| Parent |
Hivatkozás lekéri a kiszolgálóvezérlő szülővezérlőjét a lapvezérlő hierarchiájában. (Öröklődés forrása Control) |
| ProfileService |
Lekéri az ProfileServiceManager aktuális ScriptManager példányhoz társított objektumot. |
| RenderingCompatibility |
Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e. (Öröklődés forrása Control) |
| RoleService |
Lekéri az RoleServiceManager aktuális ScriptManager példányhoz társított objektumot. |
| ScriptMode |
Lekéri vagy beállít egy értéket, amely meghatározza, hogy az ügyfélszkript-kódtárak hibakeresési vagy kiadási verziói renderelve vannak-e. |
| ScriptPath |
Elavult.
Lekéri vagy beállítja annak a helynek a gyökérútvonalát, amely az Ajax- és egyéni szkriptfájlok ASP.NET elérési útjainak létrehozásához használatos. |
| ScriptResourceMapping |
Lekéri az objektumot ScriptResourceMapping . |
| Scripts |
ScriptReferenceCollection Lekéri az ScriptReference objektumokat tartalmazó objektumokat, amelyek mindegyike az ügyfél számára renderelt szkriptfájlt jelöli. |
| Services |
Lekéri a ServiceReferenceCollection objektumot, amely ServiceReference objektumot tartalmaz minden olyan webszolgáltatáshoz, amelyet ASP.NET elérhetővé tesz az ügyfélen az Ajax-funkciókhoz. |
| Site |
Információt kap arról a tárolóról, amely az aktuális vezérlőt üzemelteti, amikor egy tervezőfelületen rendereli. (Öröklődés forrása Control) |
| SkinID |
Lekéri vagy beállítja a bőrt, hogy alkalmazza a vezérlőt. (Öröklődés forrása Control) |
| SupportsPartialRendering |
Beolvas egy értéket, amely jelzi, hogy az ügyfél támogatja-e a részleges oldalmegjelenítést. |
| TemplateControl |
Lekéri vagy beállítja a vezérlőt tartalmazó sablonra mutató hivatkozást. (Öröklődés forrása Control) |
| TemplateSourceDirectory |
Lekéri az aktuális kiszolgálóvezérlő virtuális Page könyvtárátUserControl. (Öröklődés forrása Control) |
| UniqueID |
Lekéri a kiszolgálóvezérlő egyedi, hierarchikusan minősített azonosítót. (Öröklődés forrása Control) |
| ValidateRequestMode |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő ellenőrzi-e a böngészőből érkező ügyfélbemenetet a potenciálisan veszélyes értékekért. (Öröklődés forrása Control) |
| ViewState |
Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy kiszolgálóvezérlő nézetállapotának mentését és visszaállítását ugyanazon lap több kérése között. (Öröklődés forrása Control) |
| ViewStateIgnoresCase |
Olyan értéket kap, amely jelzi, hogy az StateBag objektum kis- és nagybetűket nem érzékelyítő-e. (Öröklődés forrása Control) |
| ViewStateMode |
Lekéri vagy beállítja ennek a vezérlőelemnek a nézetállapot-módját. (Öröklődés forrása Control) |
| Visible |
Felülbírálja az Visible alaposztálytól Control örökölt tulajdonságot az érték beállításának megakadályozása érdekében. |
Metódusok
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
A rendszer meghívja, miután egy gyermekvezérlőt hozzáadtak az ControlsControl objektum gyűjteményéhez. (Öröklődés forrása Control) |
| AddHistoryPoint(NameValueCollection, String) |
Létrehoz egy előzménypontot, és hozzáadja a böngésző előzményvereméhez a megadott állapotadatok gyűjtésével és állapotcímével. |
| AddHistoryPoint(String, String, String) |
Létrehoz egy előzménypontot, és hozzáadja a böngésző előzményvereméhez a megadott állapotkulcs, állapotérték és állapotcím használatával. |
| AddHistoryPoint(String, String) |
Létrehoz egy előzménypontot, és hozzáadja a böngésző előzményvereméhez a megadott állapotkulcs és állapotérték használatával. |
| AddParsedSubObject(Object) |
Értesíti a kiszolgálóvezérlőt, hogy egy ELEM (XML vagy HTML) elemzése megtörtént, és hozzáadja az elemet a kiszolgálóvezérlő objektumához ControlCollection . (Öröklődés forrása Control) |
| ApplyStyleSheetSkin(Page) |
Alkalmazza a lapstíluslapon definiált stílustulajdonságokat a vezérlőelemre. (Öröklődés forrása Control) |
| BeginRenderTracing(TextWriter, Object) |
Megkezdi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control) |
| BuildProfileTree(String, Boolean) |
Adatokat gyűjt a kiszolgálóvezérlőről, és elküldi azt a Trace tulajdonságnak, amely akkor jelenik meg, ha a nyomkövetés engedélyezve van az oldalon. (Öröklődés forrása Control) |
| ClearCachedClientID() |
A gyorsítótárazott ClientID érték beállítása a következőre |
| ClearChildControlState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek vezérlőállapot-adatait. (Öröklődés forrása Control) |
| ClearChildState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot- és vezérlőállapot-információit. (Öröklődés forrása Control) |
| ClearChildViewState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot-adatait. (Öröklődés forrása Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Az aktuális vezérlőpéldány és a gyermekvezérlők tulajdonságát a következőre Inheritállítja be: . (Öröklődés forrása Control) |
| CreateChildControls() |
A ASP.NET lap keretrendszere meghívta, hogy értesítse a kompozícióalapú implementációt használó kiszolgálóvezérlőket az általuk tartalmazott gyermekvezérlők létrehozására a visszaküldésre vagy a renderelésre való felkészüléshez. (Öröklődés forrása Control) |
| CreateControlCollection() |
Létrehoz egy új ControlCollection objektumot a kiszolgálóvezérlő gyermekvezérlőinek (konstans és kiszolgáló) tárolásához. (Öröklődés forrása Control) |
| DataBind() |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti. (Öröklődés forrása Control) |
| DataBind(Boolean) |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására. (Öröklődés forrása Control) |
| DataBindChildren() |
Adatforrás kötése a kiszolgálóvezérlő gyermekvezérlőihez. (Öröklődés forrása Control) |
| Dispose() |
Lehetővé teszi a kiszolgálóvezérlők számára a végleges törlést, mielőtt felszabadítanák a memóriából. (Öröklődés forrása Control) |
| EndRenderTracing(TextWriter, Object) |
Befejezi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control) |
| EnsureChildControls() |
Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. Ha nem, gyermekvezérlőket hoz létre. (Öröklődés forrása Control) |
| EnsureID() |
Azonosítót hoz létre azokhoz a vezérlőkhöz, amelyekhez nincs hozzárendelve azonosító. (Öröklődés forrása Control) |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| FindControl(String, Int32) |
Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott |
| FindControl(String) |
Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott |
| Focus() |
Vezérlőre állítja a bemeneti fókuszt. (Öröklődés forrása Control) |
| GetCurrent(Page) |
Lekéri egy ScriptManager adott Page objektum példányát. |
| GetDesignModeState() |
Lekéri a vezérlők tervezési idejének adatait. (Öröklődés forrása Control) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetRegisteredArrayDeclarations() |
Lekéri az objektumban korábban regisztrált ECMAScript -tömbdeklarációk írásvédett gyűjteményét Page . |
| GetRegisteredClientScriptBlocks() |
Lekéri a vezérlővel korábban regisztrált ügyfélszkriptblokkok írásvédett gyűjteményét ScriptManager . |
| GetRegisteredDisposeScripts() |
Lekéri az objektumban korábban regisztrált szkriptek írásvédett gyűjteményét |
| GetRegisteredExpandoAttributes() |
Lekéri az objektumban korábban regisztrált egyéni (expando) attribútumok írásvédett gyűjteményét Page . |
| GetRegisteredHiddenFields() |
Lekéri az objektumban korábban regisztrált rejtett mezők írásvédett gyűjteményét Page . |
| GetRegisteredOnSubmitStatements() |
Lekéri az objektumban korábban regisztrált utasítások írásvédett gyűjteményét |
| GetRegisteredStartupScripts() |
Lekéri az objektumban korábban regisztrált indítási szkriptek írásvédett gyűjteményét Page . |
| GetRouteUrl(Object) |
Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(RouteValueDictionary) |
Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(String, Object) |
Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetStateString() |
Olyan sztringet kér le, amely a weblap állapotát képviselő kulcs-érték párokat tartalmaz. |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| GetUniqueIDRelativeTo(Control) |
A megadott vezérlőelem tulajdonságának UniqueID előtaggal jelölt részét adja vissza. (Öröklődés forrása Control) |
| HasControls() |
Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. (Öröklődés forrása Control) |
| HasEvents() |
Egy értéket ad vissza, amely jelzi, hogy az események regisztrálva vannak-e a vezérlőelemhez vagy bármely gyermekvezérlőhöz. (Öröklődés forrása Control) |
| IsLiteralContent() |
Meghatározza, hogy a kiszolgálóvezérlő csak literális tartalmat tartalmaz-e. (Öröklődés forrása Control) |
| LoadControlState(Object) |
Visszaállítja a vezérlőállapot adatait egy korábbi lapkérésből, amelyet a SaveControlState() metódus mentett. (Öröklődés forrása Control) |
| LoadPostData(String, NameValueCollection) |
Beolvassa a böngészőből a kiszolgálóra közzétett űrlapadatokat, és meghatározza az aszinkron visszavétel forrását. |
| LoadViewState(Object) |
Visszaállítja a nézetállapot adatait egy korábbi oldalkérésből, amelyet a SaveViewState() metódus mentett. (Öröklődés forrása Control) |
| MapPathSecure(String) |
Lekéri azt a fizikai útvonalat, amelybe egy virtuális elérési út abszolút vagy relatív értékként van leképezve. (Öröklődés forrása Control) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Az eseményt emeli AsyncPostBackError ki. |
| OnBubbleEvent(Object, EventArgs) |
Meghatározza, hogy a kiszolgálóvezérlő eseménye átadva van-e a lap felhasználói felület kiszolgálóvezérlő hierarchiájának. (Öröklődés forrása Control) |
| OnDataBinding(EventArgs) |
Az eseményt emeli DataBinding ki. (Öröklődés forrása Control) |
| OnInit(EventArgs) |
Beállítja az eseményt Init , és gondoskodik arról, hogy csak egy ScriptManager vezérlő legyen a lapon. |
| OnLoad(EventArgs) |
Az eseményt emeli Load ki. (Öröklődés forrása Control) |
| OnPreRender(EventArgs) |
Aktiválja az PreRender eseményt, és szkriptfájlokat és szolgáltatásokat regisztrál a részleges oldalfrissítésekhez. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
Az eseményt emeli ResolveCompositeScriptReference ki. |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
ResolveScriptReference A vezérlő által felügyelt szkripthivatkozások eseményét emeli ScriptManager ki. |
| OnUnload(EventArgs) |
Az eseményt emeli Unload ki. (Öröklődés forrása Control) |
| OpenFile(String) |
Lekéri a Stream fájl olvasásához használt fájlokat. (Öröklődés forrása Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Hozzárendeli az esemény minden forrását és információját a vezérlő szülőjének. (Öröklődés forrása Control) |
| RaisePostBackEvent(String) |
Feldolgozza a ScriptManager vezérlőelem által kiváltott utólagos eseményt, és betölti a weblap előzményállapotát. |
| RaisePostDataChangedEvent() |
Eseményeket hoz elő a ScriptManager vezérlő számára, amikor visszahelyozza a kiszolgálóra. |
| RegisterArrayDeclaration(Control, String, String) |
Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz. |
| RegisterArrayDeclaration(Page, String, String) |
Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz. |
| RegisterAsyncPostBackControl(Control) |
Egy vezérlőt regisztrál eseményindítóként az aszinkron visszavételekhez. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Regisztrál egy ügyfélszkriptblokkot a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáadja a szkriptblokkot a laphoz. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Regisztrál egy ügyfélszkriptblokkot a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáadja a szkriptblokkot a laphoz. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Regisztrál egy ügyfélszkriptfájlt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Minden alkalommal regisztrálja az ügyfélszkriptet a ScriptManager vezérlővel, amikor aszinkron utólagos visszaállítás történik, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz. |
| RegisterClientScriptResource(Control, Type, String) |
Regisztrálja a szerelvénybe ágyazott ügyfélszkriptet a ScriptManager részbenoldalas megjelenítésben részt vevő vezérlővel való használatra. |
| RegisterClientScriptResource(Page, Type, String) |
Regisztrál egy olyan ügyfélszkriptfájlt, amely egy szerelvénybe van ágyazva, minden alkalommal, ScriptManager amikor a visszavétel történik. |
| RegisterDataItem(Control, String, Boolean) |
Egyéni adatokat küld egy vezérlőnek a részleges oldalmegjelenítés során, és jelzi, hogy az adatok JavaScript Object Notation (JSON) formátumban vannak-e. |
| RegisterDataItem(Control, String) |
Egyéni adatokat küld egy vezérlőnek a részleges oldalmegjelenítés során. |
| RegisterDispose(Control, String) |
|
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Egy név-érték pár regisztrálása a ScriptManager vezérlővel egy adott vezérlőelem egyéni (expando) attribútumaként. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Regisztrál egy bővítő vezérlőelemet az aktuális ScriptManager példánnyal. |
| RegisterHiddenField(Control, String, String) |
Egy vezérlőelemen belüli ScriptManager vezérlőelem vezérlőelemével UpdatePanel egy rejtett mezőt regisztrál. |
| RegisterHiddenField(Page, String, String) |
Egy rejtett mezőt regisztrál a vezérlővel minden ScriptManager aszinkron visszavétel során. |
| RegisterNamedClientScriptResource(Control, String) |
Az ügyfélszkriptet erőforrásnév alapján regisztrálja, amely egy szerelvénybe van ágyazva, és a ScriptManager vezérlőt egy részbenoldalas renderelésben részt vevő vezérlővel használja. |
| RegisterNamedClientScriptResource(Page, String) |
Az ügyfélszkriptet erőforrásnév alapján regisztrálja, amely egy szerelvénybe van ágyazva, és a ScriptManager vezérlőt egy részbenoldalas renderelésben részt vevő vezérlővel használja. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Regisztrálja az ECMAScript -kódot (JavaScript) egy ScriptManager vezérlő vezérlőjével, amelyet egy UpdatePanel olyan vezérlővel használ, amely az űrlap elküldésekor lesz végrehajtva. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Regisztrálja az ECMAScript -kódot (JavaScript) egy ScriptManager vezérlő vezérlőjével, amelyet egy UpdatePanel olyan vezérlővel használ, amely az űrlap elküldésekor lesz végrehajtva. |
| RegisterPostBackControl(Control) |
Egy vezérlőt regisztrál eseményindítóként a postbackhez. Ez a módszer a postback vezérlők konfigurálására szolgál olyan UpdatePanel vezérlőn belül, amely egyébként aszinkron utóvisszavételt végezne. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Egy szkriptvezérlőt regisztrál az aktuális ScriptManager példánnyal. |
| RegisterScriptDescriptors(IExtenderControl) |
Visszahív egy ExtenderControl osztályt, hogy olyan példányszkripteket adjon vissza, amelyeket renderelni kell az ügyfélobjektum támogatásához, amely egy ügyfélvezérlőt, összetevőt vagy viselkedést jelöl. |
| RegisterScriptDescriptors(IScriptControl) |
Meghív egy osztályt ScriptControl , hogy olyan példányszkripteket adjon vissza, amelyeket renderelni kell az ügyfélobjektum támogatásához, amely egy ügyfélvezérlőt, összetevőt vagy viselkedést jelöl. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Regisztrál egy indítási szkriptblokkot egy vezérlőelemhez, amely egy UpdatePanel vezérlőn belül ScriptManager található, és hozzáadja a szkriptblokkot a laphoz. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Regisztrál egy indítási szkriptblokkot minden aszinkron utómunkához a ScriptManager vezérlővel, és hozzáadja a szkriptblokkot a laphoz. |
| RemovedControl(Control) |
A rendszer meghívja a gyermekvezérlőt az Controls objektum gyűjteményéből való Control eltávolítása után. (Öröklődés forrása Control) |
| Render(HtmlTextWriter) |
A vezérlő tartalmát a ScriptManager megadott HtmlTextWriter objektummal jeleníti meg a böngészőben. |
| RenderChildren(HtmlTextWriter) |
Egy kiszolgálóvezérlő gyermekeinek tartalmát egy megadott HtmlTextWriter objektumba adja ki, amely megírja a megjelenítendő tartalmat az ügyfélen. (Öröklődés forrása Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriterControlAdapter objektummal vezérli. (Öröklődés forrása Control) |
| RenderControl(HtmlTextWriter) |
A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja. (Öröklődés forrása Control) |
| ResolveAdapter() |
Lekéri a megadott vezérlő megjelenítéséért felelős vezérlőadaptert. (Öröklődés forrása Control) |
| ResolveClientUrl(String) |
Lekéri a böngésző által használható URL-címet. (Öröklődés forrása Control) |
| ResolveUrl(String) |
Átalakít egy URL-címet a kérelmező ügyfélen használhatóvá. (Öröklődés forrása Control) |
| SaveControlState() |
Menti azokat a kiszolgálóvezérlő-állapotváltozásokat, amelyek a lap kiszolgálóra való visszatérése óta történtek. (Öröklődés forrása Control) |
| SaveViewState() |
Menti azokat a kiszolgálóvezérlő nézetállapot-módosításokat, amelyek a lap kiszolgálóra való visszatérése óta történtek. (Öröklődés forrása Control) |
| SetDesignModeState(IDictionary) |
Beállítja a vezérlőelemek tervezési idejének adatait. (Öröklődés forrása Control) |
| SetFocus(Control) |
Beállítja a böngészőfókuszt a megadott vezérlőre. |
| SetFocus(String) |
Beállítja a böngészőfókuszt az azonosító által megadott vezérlőre. |
| SetRenderMethodDelegate(RenderMethod) |
Hozzárendel egy eseménykezelő delegáltat, hogy a kiszolgálóvezérlőt és annak tartalmát a szülővezérlőbe renderelje. (Öröklődés forrása Control) |
| SetTraceData(Object, Object, Object) |
Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomkövetéséhez a nyomkövetési objektum, a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control) |
| SetTraceData(Object, Object) |
Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomon követéséhez a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
| TrackViewState() |
A kiszolgálóvezérlő nézetállapot-változásainak nyomon követését okozza, hogy azok a kiszolgálóvezérlő StateBag objektumában tárolhatók legyenek. Ez az objektum a ViewState tulajdonságon keresztül érhető el. (Öröklődés forrása Control) |
esemény
| Name | Description |
|---|---|
| AsyncPostBackError |
Akkor fordul elő, ha az aszinkron visszavétel során laphiba lép fel. |
| DataBinding |
Akkor fordul elő, ha a kiszolgálóvezérlő egy adatforráshoz kapcsolódik. (Öröklődés forrása Control) |
| Disposed |
Akkor fordul elő, ha egy kiszolgálóvezérlő felszabadul a memóriából, amely a kiszolgálóvezérlő életciklusának utolsó szakasza, amikor egy ASP.NET lapot kérnek. (Öröklődés forrása Control) |
| Init |
A kiszolgálóvezérlő inicializálásakor következik be, amely az életciklus első lépése. (Öröklődés forrása Control) |
| Load |
Akkor fordul elő, ha a kiszolgálóvezérlő be van töltve az Page objektumba. (Öröklődés forrása Control) |
| Navigate |
Akkor fordul elő, ha a felhasználó a böngésző Vissza vagy Továbbítás gombjára kattint. |
| PreRender |
Az objektum betöltése után Control , de a renderelés előtt következik be. (Öröklődés forrása Control) |
| ResolveCompositeScriptReference |
Akkor fordul elő, ha egy összetett szkript regisztrálva van a ScriptManager vezérlővel. |
| ResolveScriptReference |
Akkor fordul elő, ha a Scripts gyűjtemény egy tagja regisztrálva van a ScriptManager vezérlővel. |
| Unload |
Akkor fordul elő, ha a kiszolgálóvezérlő ki van ürítve a memóriából. (Öröklődés forrása Control) |
Explicit interfész-implementációk
Bővítő metódusok
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
A megadott vezérlőhöz tartozó adatforrást adja vissza. |
| FindFieldTemplate(Control, String) |
Visszaadja a megadott oszlop mezősablonját a megadott vezérlő elnevezési tárolójában. |
| FindMetaTable(Control) |
Az adatvezérlő metatáblás objektumát adja vissza. |