UpdateProgress Klasse

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt visuelles Feedback im Browser bereit, wenn der Inhalt eines oder mehrerer UpdatePanel Steuerelemente aktualisiert wird.

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

Vererbung: Object

Control
UpdateProgress

Attribute: ToolboxBitmapAttribute

Implementiert: IScriptControl IAttributeAccessor

Beispiele

In den folgenden Beispielen werden unterschiedliche Möglichkeiten zum Anzeigen des UpdateProgress Status während asynchroner Postbacks gezeigt.

Das folgende Beispiel zeigt ein UpdateProgress Steuerelement, das den Statusstatus für zwei UpdatePanel Steuerelemente anzeigt.

<%@ 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>

Das folgende Beispiel zeigt zwei UpdateProgress Steuerelemente. Jedes Steuerelement zeigt den Statusstatus für ein zugeordnetes UpdatePanel Steuerelement an.

<%@ 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>

Hinweise

In diesem Thema:

Introduction
Zuordnen eines UpdateProgress zu einem UpdatePanel-Steuerelement
Angeben des Inhalts des UpdateProgress-Steuerelements
Einfügen von UpdateProgress-Steuerelementen auf der Seite
Anpassen, wann UpdateProgress-Steuerelemente angezeigt werden
Anwenden von CSS-Formatvorlagen
Deklarative Syntax

Einführung

Mit dem UpdateProgress Steuerelement können Sie Feedback zum Fortschritt des Teilweisen Seitenrenderings bereitstellen. Bei Postbacks oder anfänglichen Seitenrendering UpdateProgress wird der Steuerelementinhalt nicht angezeigt.

Die Seite kann mehrere UpdateProgress Steuerelemente enthalten. Jeder kann einem anderen UpdatePanel Steuerelement zugeordnet werden. Alternativ können Sie ein UpdateProgress Steuerelement verwenden und es allen UpdatePanel Steuerelementen auf der Seite zuordnen.

Das UpdateProgress Steuerelement rendert ein div Element, das angezeigt oder ausgeblendet wird, je nachdem, wo ein Postback entsteht und ob die AssociatedUpdatePanelID Eigenschaft des UpdateProgress Steuerelements festgelegt ist.

Zuordnen eines UpdateProgress zu einem UpdatePanel-Steuerelement

Sie ordnen UpdateProgress Steuerelemente einem UpdatePanel Steuerelement zu, indem Sie die AssociatedUpdatePanelID Eigenschaft des UpdateProgress Steuerelements festlegen. Wenn ein Postbackereignis aus einem UpdatePanel Steuerelement stammt, werden alle zugehörigen UpdateProgress Steuerelemente angezeigt. Wenn Sie die AssociatedUpdatePanelID Eigenschaft nicht festlegen, zeigt das UpdateProgress Steuerelement den Fortschritt für alle asynchronen Postbacks an, die aus einem Steuerelement UpdatePanel stammen. Sie wird auch für alle Steuerelemente angezeigt, die für Panels ausgelöst werden.

Die AssociatedUpdatePanelID Eigenschaft hat die folgende Auswirkung auf UpdateProgress das Steuerelementverhalten:

Wenn die AssociatedUpdatePanelID Eigenschaft nicht festgelegt ist, wird das UpdateProgress Steuerelement für die folgenden Postbacks angezeigt:
- Postbacks, die innerhalb eines steuerelements UpdatePanel stammen.
- Postbacks, die aus Steuerelementen stammen, die asynchrone Trigger für jedes UpdatePanel Steuerelement sind.
Wenn die AssociatedUpdatePanelID Eigenschaft auf eine UpdatePanel Steuerelement-ID festgelegt ist, wird das UpdateProgress Steuerelement für Postbacks angezeigt, die aus dem zugeordneten UpdatePanel Steuerelement stammen.

Wenn die AssociatedUpdatePanelID Eigenschaft auf ein Steuerelement festgelegt ist, das nicht vorhanden ist, wird das UpdateProgress Steuerelement nie angezeigt.

Wenn die ChildrenAsTriggers Eigenschaft der UpdatePanel Steuerelemente auf false und ein Postback aus einem UpdatePanel Steuerelement stammt, werden alle zugehörigen UpdateProgress Steuerelemente weiterhin angezeigt.

Angeben des Inhalts des UpdateProgress-Steuerelements

Verwenden Sie die ProgressTemplate Eigenschaft, um die Nachricht anzugeben, die von einem UpdateProgress Steuerelement angezeigt wird. Wenn die ProgressTemplate Eigenschaft leer ist, wird beim Anzeigen des UpdateProgress Steuerelements nichts angezeigt.

Die Vorlage kann HTML und Markup enthalten. Sie können z. B. ein animiertes Bild anzeigen, das den Benutzer benachrichtigt, dass der Postback verarbeitet wird. Sie können auch eine Schaltfläche anzeigen, auf die der Benutzer klicken kann, um die Teilweise-Seitenaktualisierung zu beenden. Darüber hinaus möchten Sie möglicherweise alle anderen Postbacks verhindern, während ein Postback ausgeführt wird. Das folgende Beispiel zeigt ein Clientskript, das Sie zum Ausführen dieser Aufgaben verwenden können.

<%@ 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>

Sie können den Beispielcode verwenden, indem Sie das onClick Attribut eines HtmlButton Steuerelements auf "AbortPostBack()" festlegen.

Einfügen von UpdateProgress-Steuerelementen auf der Seite

UpdateProgress Steuerelemente können sich innerhalb oder außerhalb anderer UpdatePanel Steuerelemente befinden. Die Anzeige der UpdateProgress Steuerelementvorlage hängt nicht davon ab, wo sich das UpdateProgress Steuerelement befindet. In einem geschachtelten UpdatePanel Steuerelement befindet sich ein untergeordnetes Panel in einem übergeordneten Bereich. In diesem Fall bewirkt ein Postback, das aus dem untergeordneten Bereich stammt, alle UpdateProgress steuerelemente, die dem untergeordneten Bereich und dem übergeordneten Bereich zugeordnet sind, angezeigt werden. Wenn ein Postback aus einem unmittelbar untergeordneten Steuerelement des übergeordneten Bereichs stammt, werden nur die Steuerelemente angezeigt, die UpdateProgress dem übergeordneten Bereich zugeordnet sind.

Anpassen, wann UpdateProgress-Steuerelemente angezeigt werden

Standardmäßig wartet das UpdateProgress Steuerelement 0,5 Sekunden (500 Millisekunden), bevor der Inhalt angezeigt wird. Dadurch wird verhindert, dass das Steuerelement blinkt, wenn ein asynchroner Postback sehr schnell ist. Sie können die Verzögerung angeben, indem Sie die DisplayAfter Eigenschaft festlegen.

Wenn Sie eine genauere Kontrolle darüber benötigen, wann ein UpdateProgress Steuerelement angezeigt wird, können Sie Clientskript für die beginRequest und endRequest Ereignisse der PageRequestManager Klasse bereitstellen. beginRequest Im Ereignishandler können Sie das DOM-Element anzeigen, das das UpdateProgress Steuerelement darstellt. endRequest Im Ereignishandler können Sie ihn ausblenden.

Sie müssen ein Clientskript bereitstellen, um ein UpdateProgress Steuerelement anzuzeigen, wenn ein Zielsteuerelement UpdatePanel unter den folgenden Umständen aktualisiert wird:

Wenn ein Postback aus einem Steuerelement als asynchroner Postbacktrigger für das Panel registriert wird und ein UpdateProgress Steuerelement auf der Seite vorhanden ist. Die AssociatedUpdatePanelID Eigenschaft ist jedoch nicht auf die ID des Panels festgelegt.
Wenn Postbacks aus Steuerelementen mithilfe der RegisterAsyncPostBackControl Methode des ScriptManager Steuerelements als asynchrone Postbacksteuerelemente registriert werden.

Anwenden von CSS-Formatvorlagen

Das UpdateProgress Steuerelement akzeptiert expando-Attribute. Dadurch kann eine CSS-Klasse für die HTML-Elemente festgelegt werden, die von den Steuerelementen gerendert werden. Sie können beispielsweise das im folgenden Beispiel gezeigte Markup erstellen:

<asp:UpdateProgress runat="server" class="myStyle">
</asp: UpdateProgress>

Das Markup im vorherigen Beispiel rendert HTML ähnlich wie beim Ausführen der Seite:

<div id="ctl00_MainContent_UpdateProgress1" class="myStyle">
</div>

Deklarative Syntax

<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>

Konstruktoren

Name	Beschreibung
UpdateProgress()	Initialisiert eine neue Instanz der UpdateProgress-Klasse.

Eigenschaften

Name	Beschreibung
Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control)
AppRelativeTemplateSourceDirectory	Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control)
AssociatedUpdatePanelID	Dient zum Abrufen oder Festlegen der ID des UpdatePanel Steuerelements, für das das UpdateProgress Steuerelement den Status anzeigt.
Attributes	Ruft die CSS-Attribute (Cascading Stylesheet) des UpdateProgress Steuerelements ab oder legt diese fest.
BindingContainer	Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control)
ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control)
ClientID	Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control)
ClientIDMode	Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
ClientIDSeparator	Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
Context	Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control)
Controls	Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente des UpdateProgress Steuerelements darstellt.
DataItemContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control)
DataKeysContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control)
DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control)
DisplayAfter	Ruft den Wert in Millisekunden ab, bevor das Steuerelement angezeigt wird, oder legt den UpdateProgress Wert fest.
DynamicLayout	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob die Statusvorlage dynamisch gerendert wird.
EnableTheming	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von Control)
EnableViewState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control)
Events	Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control)
HasChildViewState	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control)
ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control)
IdSeparator	Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control)
IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control)
IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control)
LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control)
NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control)
Page	Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control)
Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control)
ProgressTemplate	Dient zum Abrufen oder Festlegen der Vorlage, die den Inhalt des UpdateProgress Steuerelements definiert.
RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control)
Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control)
SkinID	Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von Control)
TemplateControl	Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control)
TemplateSourceDirectory	Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control)
UniqueID	Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control)
ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control)
ViewStateMode	Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control)

Methoden

Name	Beschreibung
AddedControl(Control, Int32)	Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control)
AddParsedSubObject(Object)	Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control)
ApplyStyleSheetSkin(Page)	Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control)
BeginRenderTracing(TextWriter, Object)	Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
BuildProfileTree(String, Boolean)	Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control)
ClearCachedClientID()	Legt den zwischengespeicherten ClientID Wert auf `null`. (Geerbt von Control)
ClearChildControlState()	Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildState()	Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildViewState()	Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearEffectiveClientIDMode()	Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control)
CreateChildControls()	Wird aufgerufen, um alle untergeordneten Steuerelemente zu erstellen, die das UpdateProgress Steuerelement zur Vorbereitung auf das Zurück- oder Rendern enthält.
CreateControlCollection()	Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control)
DataBind()	Bindet eine Datenquelle an das UpdateProgress Steuerelement und alle untergeordneten Steuerelemente.
DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control)
DataBindChildren()	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
Dispose()	Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control)
EndRenderTracing(TextWriter, Object)	Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
EnsureChildControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control)
EnsureID()	Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen `id` und einer ganzzahligen Zahl, die `pathOffset` im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen. (Geerbt von Control)
FindControl(String)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen `id` Parameter. (Geerbt von Control)
Focus()	Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control)
GetDesignModeState()	Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetScriptDescriptors()	Gibt eine Liste der Komponenten, Verhaltensweisen und Clientsteuerelemente zurück, die für die Clientfunktionalität des UpdateProgress Steuerelements erforderlich sind.
GetScriptReferences()	Gibt eine Liste der Clientskriptbibliotheksabhängigkeiten für das UpdateProgress Steuerelement zurück.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetUniqueIDRelativeTo(Control)	Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control)
HasControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control)
HasEvents()	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control)
IsLiteralContent()	Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control)
LoadControlState(Object)	Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control)
LoadViewState(Object)	Stellt Ansichtsstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveViewState() Methode gespeichert wurde. (Geerbt von Control)
MapPathSecure(String)	Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnBubbleEvent(Object, EventArgs)	Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control)
OnDataBinding(EventArgs)	Löst das DataBinding-Ereignis aus. (Geerbt von Control)
OnInit(EventArgs)	Löst das Init-Ereignis aus. (Geerbt von Control)
OnLoad(EventArgs)	Löst das Load-Ereignis aus. (Geerbt von Control)
OnPreRender(EventArgs)	Löst das PreRender-Ereignis aus.
OnUnload(EventArgs)	Löst das Unload-Ereignis aus. (Geerbt von Control)
OpenFile(String)	Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)	Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control)
RemovedControl(Control)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control)
Render(HtmlTextWriter)	Schreibt den gerenderten Inhalt des UpdateProgress Steuerelements mithilfe des angegebenen HtmlTextWriter Objekts in den Browser.
RenderChildren(HtmlTextWriter)	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriter ControlAdapter Objekt aus. (Geerbt von Control)
RenderControl(HtmlTextWriter)	Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control)
ResolveAdapter()	Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control)
ResolveClientUrl(String)	Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control)
ResolveUrl(String)	Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control)
SaveControlState()	Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control)
SaveViewState()	Speichert alle Änderungen des Ansichtszustands des Serversteuerelements, die seit dem Zeitpunkt, zu dem die Seite zurück auf den Server gepostet wurde, aufgetreten sind. (Geerbt von Control)
SetDesignModeState(IDictionary)	Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)	Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control)
SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden. (Geerbt von Control)

Ereignisse

Name	Beschreibung
DataBinding	Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control)
Disposed	Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control)
Init	Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control)
Load	Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control)
PreRender	Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control)
Unload	Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IAttributeAccessor.GetAttribute(String)	Gibt ein Attribut eines Websteuerelements mithilfe des angegebenen Namens zurück.
IAttributeAccessor.SetAttribute(String, String)	Legt den Wert des angegebenen Benutzersteuerelement-Attributs fest.
IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()	Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control)
IControlDesignerAccessor.UserData	Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control)
IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control)
IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control)
IExpressionsAccessor.Expressions	Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control)
IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)	Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control)
IScriptControl.GetScriptDescriptors()	Eine Beschreibung dieses Mitglieds finden Sie unter GetScriptDescriptors().
IScriptControl.GetScriptReferences()	Eine Beschreibung dieses Mitglieds finden Sie unter GetScriptReferences().

Erweiterungsmethoden

Name	Beschreibung
FindDataSourceControl(Control)	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.
FindFieldTemplate(Control, String)	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.
FindMetaTable(Control)	Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?