|
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
|
Übersetzung
Original
|
UpdatePanel-Klasse
Namespace: System.Web.UI
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
Der UpdatePanel-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
 | Adapter | |
| AppRelativeTemplateSourceDirectory | |
| Attributes | |
| BindingContainer | Infrastruktur. |
| ChildControlsCreated | |
| ChildrenAsTriggers | |
| ClientID | |
| ClientIDMode | |
| ClientIDSeparator | |
| ContentTemplate | |
| ContentTemplateContainer | |
| Context | |
| Controls | |
| DataItemContainer | |
| DataKeysContainer | |
| DesignMode | |
| EnableTheming | |
| EnableViewState | |
| Events | |
| HasChildViewState | |
| ID | |
| IdSeparator | Infrastruktur. |
| IsChildControlStateCleared | |
| IsInPartialRendering | |
| IsTrackingViewState | |
| IsViewStateEnabled | |
| LoadViewStateByID | |
| NamingContainer | |
| Page | |
| Parent | |
| RenderingCompatibility | |
| RenderMode | |
| RequiresUpdate | |
| Site | |
| SkinID | |
| TemplateControl | |
| TemplateSourceDirectory | |
| Triggers | |
| UniqueID | |
| UpdateMode | |
| ValidateRequestMode | |
| ViewState | |
| ViewStateIgnoresCase | |
| ViewStateMode | |
| Visible |
| Name | Beschreibung | |
|---|---|---|
| AddedControl | |
| AddParsedSubObject | |
| ApplyStyleSheetSkin | |
| BeginRenderTracing | |
| BuildProfileTree | Infrastruktur. |
| ClearCachedClientID | Infrastruktur. |
| ClearChildControlState | |
| ClearChildState | |
| ClearChildViewState | |
| ClearEffectiveClientIDMode | Infrastruktur. |
| CreateChildControls | |
| CreateContentTemplateContainer | |
| CreateControlCollection | |
| DataBind() | |
| DataBind(Boolean) | |
| DataBindChildren | |
| Dispose | |
| EndRenderTracing | |
| EnsureChildControls | |
| EnsureID | |
| Equals(Object) | |
| Finalize | |
| FindControl(String) | |
| FindControl(String, Int32) | Infrastruktur. |
| Focus | |
| GetDesignModeState | Infrastruktur. |
| GetHashCode | |
| GetRouteUrl(Object) | |
| GetRouteUrl(RouteValueDictionary) | |
| GetRouteUrl(String, Object) | |
| GetRouteUrl(String, RouteValueDictionary) | |
| GetType | |
| GetUniqueIDRelativeTo | |
| HasControls | |
| HasEvents | |
| Initialize | |
| IsLiteralContent | Infrastruktur. |
| LoadControlState | |
| LoadViewState | |
| MapPathSecure | |
| MemberwiseClone | |
| OnBubbleEvent | |
| OnDataBinding | |
| OnInit | |
| OnLoad | |
| OnPreRender | |
| OnUnload | |
| OpenFile | |
| RaiseBubbleEvent | |
| RemovedControl | |
| Render | |
| RenderChildren | |
| RenderControl(HtmlTextWriter) | |
| RenderControl(HtmlTextWriter, ControlAdapter) | |
| ResolveAdapter | |
| ResolveClientUrl | |
| ResolveUrl | |
| SaveControlState | |
| SaveViewState | |
| SetDesignModeState | |
| SetRenderMethodDelegate | Infrastruktur. |
| SetTraceData(Object, Object) | |
| SetTraceData(Object, Object, Object) | |
| ToString | |
| TrackViewState | |
| Update |
| Name | Beschreibung | |
|---|---|---|
| DataBinding | |
| Disposed | |
| Init | |
| Load | |
| PreRender | |
| Unload |
| Name | Beschreibung | |
|---|---|---|
| FindDataSourceControl | |
| FindFieldTemplate | |
| FindMetaTable |
Einführung
Aktualisieren von UpdatePanel-Inhalt
Wenn die UpdateMode-Eigenschaft des UpdatePanel-Steuerelements auf Always festgelegt ist, wird der Inhalt des UpdatePanel-Steuerelements bei jedem Postback aktualisiert, der seinen Ursprung auf der Seite hat. Dies umfasst asynchrone Postbacks von Steuerelementen innerhalb von anderen UpdatePanel-Steuerelementen sowie Postbacks von Steuerelementen, die sich nicht innerhalb von UpdatePanel-Steuerelementen befinden. Wenn die UpdateMode-Eigenschaft auf Conditional festgelegt ist, wird der Inhalt des UpdatePanel-Steuerelements unter folgenden Umständen aktualisiert: Wenn Sie die Update-Methode des UpdatePanel-Steuerelements explizit aufrufen. Wenn das UpdatePanel-Steuerelement in einem anderen UpdatePanel-Steuerelement geschachtelt ist und der übergeordnete Bereich aktualisiert wird. Wenn mit der Triggers-Eigenschaft des UpdatePanel-Steuerelements ein Postback durch ein Steuerelement bewirkt wird, das als Trigger definiert ist. In diesem Szenario löst das Steuerelement explizit eine Aktualisierung des Inhalts des Bereichs aus. Das Steuerelement kann sich entweder innerhalb oder außerhalb des UpdatePanel-Steuerelements befinden, dem der Trigger zugeordnet ist. Wenn die ChildrenAsTriggers-Eigenschaft auf true festgelegt ist und ein untergeordnetes Steuerelement des UpdatePanel-Steuerelements ein Postback bewirkt. Untergeordnete Steuerelemente von geschachtelten UpdatePanel-Steuerelementen bewirken keine Aktualisierung des äußeren UpdatePanel-Steuerelements, es sei denn, sie sind explizit als Trigger definiert.
UpdatePanel-Verwendung
In Benutzersteuerelementen. Auf Masterseiten und Inhaltsseiten. Geschachtelt in anderen UpdatePanel-Steuerelementen. Innerhalb von Steuerelementen, die auf Vorlagen basieren, beispielsweise im GridView-Steuerelement oder im Repeater-Steuerelement.
Übernehmen der Formate
<asp:UpdatePanel runat="server" class="myStyle"> </asp:UpdatePanel>
<div id="ctl00_MainContent_UpdatePanel1" class="MyStyle"> </div>
Deklarative Syntax
<asp:UpdatePanel ChildrenAsTriggers="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" RenderMode="Block|Inline" runat="server" SkinID="string" UpdateMode="Always|Conditional" Visible="True|False" > <ContentTemplate> <!-- child controls --> </ContentTemplate> <Triggers> <asp:AsyncPostBackTrigger ControlID="string" EventName="string" /> <asp:PostBackTrigger ControlID="string" /> </Triggers> </asp:UpdatePanel>
Steuerelemente innerhalb eines UpdatePanel-Steuerelements
<%@ Page Language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> void DropDownSelection_Change(Object sender, EventArgs e) { Calendar1.DayStyle.BackColor = System.Drawing.Color.FromName(ColorList.SelectedItem.Value); } protected void Calendar1_SelectionChanged(object sender, EventArgs e) { SelectedDate.Text = Calendar1.SelectedDate.ToString(); } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title>UpdatePanel Example</title> </head> <body> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" runat="server" /> <asp:UpdatePanel ID="UpdatePanel1" runat="server"> <ContentTemplate> <asp:Calendar ID="Calendar1" ShowTitle="True" OnSelectionChanged="Calendar1_SelectionChanged" runat="server" /> <div> Background: <br /> <asp:DropDownList ID="ColorList" AutoPostBack="True" OnSelectedIndexChanged="DropDownSelection_Change" runat="server"> <asp:ListItem Selected="True" Value="White"> White </asp:ListItem> <asp:ListItem Value="Silver"> Silver </asp:ListItem> <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem> <asp:ListItem Value="Khaki"> Khaki </asp:ListItem> <asp:ListItem Value="DarkKhaki"> D ark Khaki </asp:ListItem> </asp:DropDownList> </div> <br /> Selected date: <asp:Label ID="SelectedDate" runat="server">None.</asp:Label> </ContentTemplate> </asp:UpdatePanel> <br /> </div> </form> </body> </html>
Master/Detail-Szenario mit UpdatePanel-Steuerelementen
<%@ 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 GridView1_SelectedIndexChanged(object sender, EventArgs e) { SqlDataSource2.SelectParameters["OrderID"].DefaultValue = GridView1.SelectedDataKey.Value.ToString(); } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title>UpdatePanel Example</title> </head> <body> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" runat="server" /> <asp:UpdatePanel ID="OrdersPanel" UpdateMode="Conditional" runat="server"> <ContentTemplate> <asp:GridView ID="GridView1" AllowPaging="True" AllowSorting="True" Caption="Orders" DataKeyNames="OrderID" DataSourceID="SqlDataSource1" OnSelectedIndexChanged="GridView1_SelectedIndexChanged" runat="server" > <Columns> <asp:CommandField ShowSelectButton="True"></asp:CommandField> </Columns> </asp:GridView> <asp:SqlDataSource ID="SqlDataSource1" runat="server" ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>" SelectCommand="SELECT [OrderID], [CustomerID], [EmployeeID], [OrderDate] FROM [Orders]"> </asp:SqlDataSource> </ContentTemplate> </asp:UpdatePanel> <asp:UpdatePanel ID="OrderDetailsPanel" UpdateMode="Always" runat="server"> <ContentTemplate> <asp:DetailsView ID="DetailsView1" Caption="Order Details" DataKeyNames="OrderID,ProductID" DataSourceID="SqlDataSource2" runat="server"> <EmptyDataTemplate> <i>Select a row from the Orders table.</i> </EmptyDataTemplate> </asp:DetailsView> <asp:SqlDataSource ID="SqlDataSource2" ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>" SelectCommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity], [Discount] FROM [Order Details] WHERE ([OrderID] = @OrderID)" runat="server"> <SelectParameters> <asp:Parameter Name="OrderID" Type="Int32" /> </SelectParameters> </asp:SqlDataSource> </ContentTemplate> </asp:UpdatePanel> </div> </form> </body> </html>
Verwenden eines UpdatePanel-Steuerelements in einer Vorlage
<%@ 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"> private void ChangeQuantity(object sender, int delta) { Label quantityLabel = (Label)((Button)sender).FindControl("QuantityLabel"); int currentQuantity = Int32.Parse(quantityLabel.Text); currentQuantity = Math.Max(0, currentQuantity + delta); quantityLabel.Text = currentQuantity.ToString(System.Globalization.CultureInfo.InvariantCulture); } private void OnDecreaseQuantity(object sender, EventArgs e) { ChangeQuantity(sender, -1); } private void OnIncreaseQuantity(object sender, EventArgs e) { ChangeQuantity(sender, 1); } protected void Button1_Click(object sender, EventArgs e) { StringBuilder sb = new StringBuilder(); sb.Append("Beverage order:<br/>"); foreach (GridViewRow row in GridView1.Rows) { if (row.RowType == DataControlRowType.DataRow) { Label quantityLabel = (Label)row.FindControl("QuantityLabel"); int currentQuantity = Int32.Parse(quantityLabel.Text); sb.Append(row.Cells[0].Text + " : " + currentQuantity + "<br/>"); } } SummaryLabel.Text = sb.ToString(); } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title>UpdatePanel Inside GridView Template Example </title> </head> <body> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" runat="server" /> <asp:GridView ID="GridView1" AutoGenerateColumns="False" DataSourceID="SqlDataSource1" runat="server"> <Columns> <asp:BoundField DataField="ProductName" HeaderText="ProductName" /> <asp:BoundField DataField="UnitPrice" HeaderText="UnitPrice" /> <asp:TemplateField HeaderText="Quantity"> <ItemTemplate> <asp:UpdatePanel ID="QuantityUpdatePanel" UpdateMode="Conditional" runat="server" > <ContentTemplate> <asp:Label ID="QuantityLabel" Text="0" runat="server" /> <asp:Button ID="DecreaseQuantity" Text="-" OnClick="OnDecreaseQuantity" runat="server" /> <asp:Button ID="IncreaseQuantity" Text="+" OnClick="OnIncreaseQuantity" runat="server" /> </ContentTemplate> </asp:UpdatePanel> </ItemTemplate> </asp:TemplateField> </Columns> </asp:GridView> <asp:UpdatePanel ID="SummaryUpdatePanel" UpdateMode="Conditional" runat="server"> <ContentTemplate> <asp:Button ID="Button1" OnClick="Button1_Click" Text="Get Summary" runat="server" /> <br /> <asp:Label ID="SummaryLabel" runat="server"> </asp:Label> </ContentTemplate> </asp:UpdatePanel> <asp:SqlDataSource ID="SqlDataSource1" ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>" SelectCommand="SELECT [ProductName], [UnitPrice] FROM [Alphabetical list of products] WHERE ([CategoryName] LIKE '%' + @CategoryName + '%')" runat="server"> <SelectParameters> <asp:Parameter DefaultValue="Beverages" Name="CategoryName" Type="String" /> </SelectParameters> </asp:SqlDataSource> </div> </form> </body> </html>
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
