UpdateProgress 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.
Vizuális visszajelzést nyújt a böngészőben egy vagy több UpdatePanel vezérlő tartalmának frissítésekor.
public ref class UpdateProgress : System::Web::UI::Control, System::Web::UI::IScriptControl
public ref class UpdateProgress : System::Web::UI::Control, System::Web::UI::IAttributeAccessor, System::Web::UI::IScriptControl
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.UpdateProgress.bmp")]
public class UpdateProgress : System.Web.UI.Control, System.Web.UI.IScriptControl
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.UpdateProgress.bmp")]
public class UpdateProgress : System.Web.UI.Control, System.Web.UI.IAttributeAccessor, System.Web.UI.IScriptControl
[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.UpdateProgress.bmp")>]
type UpdateProgress = class
inherit Control
interface IScriptControl
[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.UpdateProgress.bmp")>]
type UpdateProgress = class
inherit Control
interface IAttributeAccessor
interface IScriptControl
Public Class UpdateProgress
Inherits Control
Implements IScriptControl
Public Class UpdateProgress
Inherits Control
Implements IAttributeAccessor, IScriptControl
- Öröklődés
- Attribútumok
- Megvalósítás
Példák
Az alábbi példák különböző módszereket mutatnak be a vezérlővel az UpdateProgress aszinkron visszavételek során történő előrehaladás megjelenítésére.
Az alábbi példa egy UpdateProgress vezérlőt mutat be, amely két UpdatePanel vezérlő állapotának állapotát jeleníti meg.
<%@ 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 Button_Click(object sender, EventArgs e)
{
System.Threading.Thread.Sleep(3000);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>UpdateProgress Example</title>
<style type="text/css">
#UpdatePanel1, #UpdatePanel2, #UpdateProgress1 {
border-right: gray 1px solid; border-top: gray 1px solid;
border-left: gray 1px solid; border-bottom: gray 1px solid;
}
#UpdatePanel1, #UpdatePanel2 {
width:200px; height:200px; position: relative;
float: left; margin-left: 10px; margin-top: 10px;
}
#UpdateProgress1 {
width: 400px; background-color: #FFC080;
bottom: 0%; left: 0px; position: absolute;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdateProgress ID="UpdateProgress1" runat="server">
<ProgressTemplate>
Update in progress...
</ProgressTemplate>
</asp:UpdateProgress>
</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 Button_Click(ByVal sender As Object, ByVal e As System.EventArgs)
System.Threading.Thread.Sleep(3000)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>UpdateProgress Example</title>
<style type="text/css">
#UpdatePanel1, #UpdatePanel2, #UpdateProgress1 {
border-right: gray 1px solid; border-top: gray 1px solid;
border-left: gray 1px solid; border-bottom: gray 1px solid;
}
#UpdatePanel1, #UpdatePanel2 {
width:200px; height:200px; position: relative;
float: left; margin-left: 10px; margin-top: 10px;
}
#UpdateProgress1 {
width: 400px; background-color: #FFC080;
bottom: 0%; left: 0px; position: absolute;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdateProgress ID="UpdateProgress1" runat="server">
<ProgressTemplate>
Update in progress...
</ProgressTemplate>
</asp:UpdateProgress>
</div>
</form>
</body>
</html>
Az alábbi példa két UpdateProgress vezérlőt mutat be. Minden vezérlő megjeleníti a társított UpdatePanel vezérlő állapotának állapotát.
<%@ 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 Button_Click(object sender, EventArgs e)
{
System.Threading.Thread.Sleep(3000);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>UpdateProgress Example</title>
<style type="text/css">
#UpdatePanel1, #UpdatePanel2 {
width:200px; height:200px; position: relative;
float: left; margin-left: 10px; margin-top: 10px;
border-right: gray 1px solid; border-top: gray 1px solid;
border-left: gray 1px solid; border-bottom: gray 1px solid;
}
#UpdateProgress1, #UpdateProgress2 {
width: 200px; background-color: #FFC080;
position: absolute; bottom: 0px; left: 0px;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />
<asp:UpdateProgress ID="UpdateProgress1" AssociatedUpdatePanelID="UpdatePanel1" runat="server">
<ProgressTemplate>
UpdatePanel1 updating...
</ProgressTemplate>
</asp:UpdateProgress>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>
<asp:UpdateProgress ID="UpdateProgress2" AssociatedUpdatePanelID="UpdatePanel2" runat="server">
<ProgressTemplate>
UpdatePanel2 updating...
</ProgressTemplate>
</asp:UpdateProgress>
</ContentTemplate>
</asp:UpdatePanel>
</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 Button_Click(ByVal sender As Object, ByVal e As System.EventArgs)
System.Threading.Thread.Sleep(3000)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>UpdateProgress Example</title>
<style type="text/css">
#UpdatePanel1, #UpdatePanel2 {
width:200px; height:200px; position: relative;
float: left; margin-left: 10px; margin-top: 10px;
border-right: gray 1px solid; border-top: gray 1px solid;
border-left: gray 1px solid; border-bottom: gray 1px solid;
}
#UpdateProgress1, #UpdateProgress2 {
width: 200px; background-color: #FFC080;
position: absolute; bottom: 0px; left: 0px;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />
<asp:UpdateProgress ID="UpdateProgress1" AssociatedUpdatePanelID="UpdatePanel1" runat="server">
<ProgressTemplate>
UpdatePanel1 updating...
</ProgressTemplate>
</asp:UpdateProgress>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>
<asp:UpdateProgress ID="UpdateProgress2" AssociatedUpdatePanelID="UpdatePanel2" runat="server">
<ProgressTemplate>
UpdatePanel2 updating...
</ProgressTemplate>
</asp:UpdateProgress>
</ContentTemplate>
</asp:UpdatePanel>
</div>
</form>
</body>
</html>
Megjegyzések
Ebben a témakörben:
Bevezetés
A UpdateProgress vezérlő lehetővé teszi, hogy visszajelzést küldjön a részleges oldalmegjelenítés folyamatáról. Utólagos vagy kezdeti lapmegjelenítés UpdateProgress esetén a vezérlőtartalom nem jelenik meg.
A lap több vezérlőt UpdateProgress is tartalmazhat. Mindegyik más UpdatePanel vezérlőelemhez társítható. Másik lehetőségként használhat egy UpdateProgress vezérlőt, és társíthatja az UpdatePanel oldal összes vezérlőjével.
A UpdateProgress vezérlő megjelenít egy div megjelenített vagy rejtett elemet attól függően, hogy honnan származik a postback, és hogy a AssociatedUpdatePanelIDUpdateProgress vezérlő tulajdonsága be van-e állítva.
UpdateProgress társítása UpdatePanel-vezérlővel
A vezérlők vezérlőelemhez UpdateProgress való társítása UpdatePanel a AssociatedUpdatePanelID vezérlő tulajdonságának beállításávalUpdateProgress. Ha egy visszavételi esemény egy UpdatePanel vezérlőn belülről származik, a kapcsolódó UpdateProgress vezérlők megjelennek. Ha nem állítja be a AssociatedUpdatePanelID tulajdonságot, a vezérlő megjeleníti a UpdateProgress vezérlőelemen belülről UpdatePanel származó aszinkron utómunkák előrehaladását. A panelek eseményindítóiként szolgáló vezérlők esetében is megjelenik.
A AssociatedUpdatePanelID tulajdonság a következő hatással van a vezérlés viselkedésére UpdateProgress :
Ha a AssociatedUpdatePanelID tulajdonság nincs beállítva, a vezérlő a UpdateProgress következő utólagos visszavételekhez jelenik meg:
Bármely vezérlőn belülről UpdatePanel származó postbackek.
A vezérlőelemek aszinkron eseményindítóiból származó visszalépések.UpdatePanel
Ha a AssociatedUpdatePanelID tulajdonság vezérlőelem-azonosítóra UpdatePanel van állítva, a vezérlő megjelenik a UpdateProgress kapcsolódó UpdatePanel vezérlőn belülről származó utólagos visszavételekhez.
Ha a AssociatedUpdatePanelID tulajdonság olyan vezérlőelemre van állítva, amely nem létezik, a UpdateProgress vezérlő soha nem jelenik meg.
Ha a ChildrenAsTriggersUpdatePanel vezérlők tulajdonsága be van állítva false , és a visszavétel egy UpdatePanel vezérlőn belülről származik, a kapcsolódó UpdateProgress vezérlők továbbra is megjelennek.
Az UpdateProgress vezérlő tartalmának megadása
ProgressTemplate A tulajdonság használatával adja meg a vezérlőelem által UpdateProgress megjelenített üzenetet. Ha a ProgressTemplate tulajdonság üres, a vezérlőelem megjelenésekor UpdateProgress semmi sem jelenik meg.
A sablon tartalmazhat HTML-t és korrektúrát. Megjeleníthet például egy animált képet, amely értesíti a felhasználót a postback feldolgozásáról. Megjeleníthet egy gombot is, amellyel a felhasználó leállíthatja a részleges oldalfrissítést. Emellett előfordulhat, hogy meg szeretné akadályozni az összes többi utómunkát, amíg az egyik folyamatban van. Az alábbi példa azokat az ügyfélszkripteket mutatja be, amelyekkel elvégezheti ezeket a feladatokat.
<%@ 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 Button_Click(object sender, EventArgs e)
{
System.Threading.Thread.Sleep(3000);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>UpdateProgress Example</title>
<style type="text/css">
#UpdatePanel1, #UpdatePanel2, #UpdateProgress1 {
border-right: gray 1px solid; border-top: gray 1px solid;
border-left: gray 1px solid; border-bottom: gray 1px solid;
}
#UpdatePanel1, #UpdatePanel2 {
width:200px; height:200px; position: relative;
float: left; margin-left: 10px; margin-top: 10px;
}
#UpdateProgress1 {
width: 400px; background-color: #FFC080;
bottom: 0%; left: 0px; position: absolute;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<script type="text/javascript">
var prm = Sys.WebForms.PageRequestManager.getInstance();
prm.add_initializeRequest(InitializeRequest);
function InitializeRequest(sender, args) {
if (prm.get_isInAsyncPostBack())
{
args.set_cancel(true);
}
}
function AbortPostBack() {
if (prm.get_isInAsyncPostBack()) {
prm.abortPostBack();
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />
<br />
Clicking the button while an asynchronous postback is in progress will
cancel the new postback. New postbacks are only allowed if one is not
already in progress.
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdateProgress ID="UpdateProgress1" runat="server">
<ProgressTemplate>
Update in progress...
<input type="button" value="stop" onclick="AbortPostBack()" />
</ProgressTemplate>
</asp:UpdateProgress>
</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 Button_Click(ByVal sender As Object, ByVal e As System.EventArgs)
System.Threading.Thread.Sleep(3000)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>UpdateProgress Example</title>
<style type="text/css">
#UpdatePanel1, #UpdatePanel2, #UpdateProgress1 {
border-right: gray 1px solid; border-top: gray 1px solid;
border-left: gray 1px solid; border-bottom: gray 1px solid;
}
#UpdatePanel1, #UpdatePanel2 {
width:200px; height:200px; position: relative;
float: left; margin-left: 10px; margin-top: 10px;
}
#UpdateProgress1 {
width: 400px; background-color: #FFC080;
bottom: 0%; left: 0px; position: absolute;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<script type="text/javascript">
var prm = Sys.WebForms.PageRequestManager.getInstance();
prm.add_initializeRequest(InitializeRequest);
function InitializeRequest(sender, args) {
if (prm.get_isInAsyncPostBack())
{
args.set_cancel(true);
}
}
function AbortPostBack() {
if (prm.get_isInAsyncPostBack()) {
prm.abortPostBack();
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button1" runat="server" Text="Refresh Panel" OnClick="Button_Click" />
<br />
Clicking the button while an asynchronous postback is in progress will
cancel the new postback. New postbacks are only allowed if one is not
already in progress.
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<ContentTemplate>
<%=DateTime.Now.ToString() %> <br />
<asp:Button ID="Button2" runat="server" Text="Refresh Panel" OnClick="Button_Click"/>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdateProgress ID="UpdateProgress1" runat="server">
<ProgressTemplate>
Update in progress...
<input type="button" value="stop" onclick="AbortPostBack()" />
</ProgressTemplate>
</asp:UpdateProgress>
</div>
</form>
</body>
</html>
A példakódot úgy használhatja, hogy egy onClickHtmlButton vezérlőelem attribútumát az "AbortPostBack()" értékre állítja.
UpdateProgress-vezérlők elhelyezése a lapon
UpdateProgress vezérlők lehetnek más UpdatePanel vezérlőkön belül vagy kívül is. A vezérlő sablonjának UpdateProgress megjelenítése nem függ attól, hogy hol található a UpdateProgress vezérlő. UpdatePanel Beágyazott vezérlőkben a gyermekpanel egy szülőpanelen belül található. Ebben az esetben a gyermekpanelen belülről származó visszavétel esetén a gyermekpanelhez és a szülőpanelhez társított összes UpdateProgress vezérlő megjelenik. Ha a visszavétel a szülőpanel közvetlen gyermek vezérlőeleméből származik, csak a UpdateProgress szülőpanelhez társított vezérlők jelennek meg.
Testreszabás az UpdateProgress-vezérlők megjelenésekor
Alapértelmezés szerint a UpdateProgress vezérlő 0,5 másodpercet (500 ezredmásodpercet) vár, mielőtt megjelenítené a tartalmát. Ez segít megakadályozni, hogy a vezérlő villogjon, ha az aszinkron visszavétel nagyon gyors. A késleltetést a tulajdonság beállításával DisplayAfter adhatja meg.
Ha finomabb vezérlésre van szüksége egy UpdateProgress vezérlőelem megjelenésekor, megadhatja az beginRequest osztály eseményeinek és endRequest eseményeinek ügyfélszkriptjét PageRequestManager . Az eseménykezelőben beginRequest megjelenítheti a vezérlőt jelképező UpdateProgress DOM-elemet. Az eseménykezelőben endRequest elrejtheti.
Meg kell adnia egy ügyfélszkriptet, hogy megjelenítsen egy vezérlőt UpdateProgress , ha a célvezérlő UpdatePanel a következő körülmények között frissül:
Ha egy vezérlőelem utáni visszavétel aszinkron utólagos eseményindítóként van regisztrálva a panelen, és van egy UpdateProgress vezérlő a lapon. A AssociatedUpdatePanelID tulajdonság azonban nincs beállítva a panel azonosítójára.
Ha a vezérlők utáni visszavételek aszinkron utólagos vezérlőként vannak regisztrálva a RegisterAsyncPostBackControlScriptManager vezérlő metódusával.
CSS-stílusok alkalmazása
A UpdateProgress vezérlőelem elfogadja az expando attribútumokat. Ez lehetővé teszi egy CSS-osztály beállítását a vezérlők által megjelenített HTML-elemeken. Létrehozhatja például a következő példában látható korrektúrát:
<asp:UpdateProgress runat="server" class="myStyle">
</asp: UpdateProgress>
Az előző példában szereplő korrektúra a következőhöz hasonló HTML-t jelenít meg a lap futtatásakor:
<div id="ctl00_MainContent_UpdateProgress1" class="myStyle">
</div>
Deklaratív szintaxis
<asp:UpdateProgress
AssociatedUpdatePanelID="string"
DisplayAfter="integer"
DynamicLayout="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Visible="True|False"
>
<ProgressTemplate>
<!-- child controls -->
</ProgressTemplate>
</asp:UpdateProgress>
Konstruktorok
| Name | Description |
|---|---|
| UpdateProgress() |
Inicializálja a UpdateProgress 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) |
| 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) |
| AssociatedUpdatePanelID |
Lekéri vagy beállítja annak a vezérlőelemnek az UpdatePanel azonosítóját, amelynél a UpdateProgress vezérlő állapotot jelenít meg. |
| Attributes |
Lekéri vagy beállítja a vezérlőelem kaszkádolt stíluslapjának (CSS) attribútumait UpdateProgress . |
| 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) |
| 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 a vezérlő gyermekvezérlőinek UpdateProgress megfelelő objektumot. |
| 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) |
| DisplayAfter |
Ezredmásodpercben lekéri vagy beállítja az értéket a UpdateProgress vezérlőelem megjelenítése előtt. |
| DynamicLayout |
Lekéri vagy beállít egy értéket, amely meghatározza, hogy a folyamatsablon dinamikusan jelenik-e meg. |
| 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) |
| 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) |
| 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) |
| ProgressTemplate |
Lekéri vagy beállítja a vezérlő tartalmát meghatározó sablont UpdateProgress . |
| 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) |
| 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) |
| 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 |
Lekéri vagy beállít egy értéket, amely jelzi, hogy egy kiszolgálóvezérlő felhasználói felületként jelenik-e meg a lapon. (Öröklődés forrása Control) |
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) |
| 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 vezérlő által a UpdateProgress visszaadásra vagy a renderelésre való előkészítés során tartalmazott gyermekvezérlők létrehozásához hívható meg. |
| 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() |
Egy adatforrást a UpdateProgress vezérlőhöz és annak gyermekvezérlőihez köt. |
| 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) |
| 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) |
| 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) |
| GetScriptDescriptors() |
A vezérlő ügyfélfunkcióihoz UpdateProgress szükséges összetevők, viselkedések és ügyfélvezérlők listáját adja vissza. |
| GetScriptReferences() |
A vezérlőelem ügyfélszkripttár-függőségeinek UpdateProgress listáját adja vissza. |
| 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) |
| 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) |
| 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) |
Az eseményt emeli Init ki. (Öröklődés forrása Control) |
| OnLoad(EventArgs) |
Az eseményt emeli Load ki. (Öröklődés forrása Control) |
| OnPreRender(EventArgs) |
Az eseményt emeli PreRender 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) |
| 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ő renderelt tartalmát a UpdateProgress megadott objektum használatával írja a böngészőbe HtmlTextWriter . |
| 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) |
| 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 |
|---|---|
| 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) |
| 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) |
| 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. |