UpdateProgress Osztály

Definíció

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
UpdateProgress
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 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 null: .

(Öröklődés forrása Control)
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 id és a paraméterben pathOffset megadott egész számmal, amely segíti a keresést. Nem bírálhatja felül a FindControl metódus ezen verzióját.

(Öröklődés forrása Control)
FindControl(String)

Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott id paraméterrel.

(Öröklődés forrása Control)
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

Name Description
IAttributeAccessor.GetAttribute(String)

Egy webvezérlő attribútumát adja vissza a megadott név használatával.

IAttributeAccessor.SetAttribute(String, String)

Beállítja a megadott felhasználóvezérlő attribútum értékét.

IControlBuilderAccessor.ControlBuilder

Ennek a tagnak a leírását lásd ControlBuilder: .

(Öröklődés forrása Control)
IControlDesignerAccessor.GetDesignModeState()

Ennek a tagnak a leírását lásd GetDesignModeState(): .

(Öröklődés forrása Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Ennek a tagnak a leírását lásd SetDesignModeState(IDictionary): .

(Öröklődés forrása Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Ennek a tagnak a leírását lásd SetOwnerControl(Control): .

(Öröklődés forrása Control)
IControlDesignerAccessor.UserData

Ennek a tagnak a leírását lásd UserData: .

(Öröklődés forrása Control)
IDataBindingsAccessor.DataBindings

Ennek a tagnak a leírását lásd DataBindings: .

(Öröklődés forrása Control)
IDataBindingsAccessor.HasDataBindings

Ennek a tagnak a leírását lásd HasDataBindings: .

(Öröklődés forrása Control)
IExpressionsAccessor.Expressions

Ennek a tagnak a leírását lásd Expressions: .

(Öröklődés forrása Control)
IExpressionsAccessor.HasExpressions

Ennek a tagnak a leírását lásd HasExpressions: .

(Öröklődés forrása Control)
IParserAccessor.AddParsedSubObject(Object)

Ennek a tagnak a leírását lásd AddParsedSubObject(Object): .

(Öröklődés forrása Control)
IScriptControl.GetScriptDescriptors()

Ennek a tagnak a leírását lásd GetScriptDescriptors(): .

IScriptControl.GetScriptReferences()

Ennek a tagnak a leírását lásd GetScriptReferences(): .

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.

A következőre érvényes:

Lásd még