UpdatePanel 클래스

정의

포스트백 없이 한 페이지의 섹션을 부분적으로 렌더링할 수 있습니다.Enables sections of a page to be partially rendered without a postback.

public ref class UpdatePanel : System::Web::UI::Control, System::Web::UI::IAttributeAccessor
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.UpdatePanel.bmp")]
public class UpdatePanel : System.Web.UI.Control, System.Web.UI.IAttributeAccessor
type UpdatePanel = class
    inherit Control
    interface IAttributeAccessor
Public Class UpdatePanel
Inherits Control
Implements IAttributeAccessor
상속
UpdatePanel
특성
구현

예제

다음 예에서는 UpdatePanel 컨트롤의 다양 한 사용을 보여 줍니다.The following examples show various uses of the UpdatePanel control.

UpdatePanel 컨트롤 내의 컨트롤Controls Inside an UpdatePanel Control

다음 예제에서는 서버에 게시할 때 화면 깜박임을 줄이기 위해 UpdatePanel 컨트롤 내에 컨트롤을 배치 하는 방법을 보여 줍니다.The following example shows how to put controls inside an UpdatePanel control to reduce screen flicker when you post to the server. 이 예제에서 CalendarDropDownList 컨트롤은 UpdatePanel 컨트롤 내에 있습니다.In this example, a Calendar and a DropDownList control are inside an UpdatePanel control. 기본적으로 UpdateMode 속성은 Always 이며 ChildrenAsTriggers 속성은 true입니다.By default, the UpdateMode property is Always and the ChildrenAsTriggers property is true. 따라서 패널의 자식 컨트롤이 비동기 포스트백이 발생 합니다.Therefore, child controls of the panel cause an asynchronous postback.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
        Calendar1.DayStyle.BackColor = _
        System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
    End Sub

    Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
        SelectedDate.Text = Calendar1.SelectedDate.ToString()
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

UpdatePanel 컨트롤을 사용 하는 마스터/세부 정보 시나리오Master/Detail Scenario with UpdatePanel Controls

다음 예제에서는 Northwind 데이터베이스의 주문 및 주문 세부 정보를 표시 하는 마스터/세부 정보 시나리오에서 UpdatePanel 컨트롤을 사용 합니다.In the following example, an UpdatePanel control is used in a master/detail scenario that shows orders and order details from the Northwind database. UpdatePanel 컨트롤 하나에는 주문 목록을 표시 하는 GridView 컨트롤이 포함 됩니다.One UpdatePanel control contains the GridView control that displays a list of orders. 두 번째 UpdatePanel 컨트롤은 한 주문의 세부 정보를 표시 하는 DetailsView 컨트롤을 포함 합니다.A second UpdatePanel control contains a DetailsView control that displays the details of one order. 첫 번째 테이블에서 순서를 선택 하면 해당 주문에 대 한 세부 정보는 두 번째 테이블에 표시 됩니다.When you select an order from the first table, details for that order are displayed in the second table. 두 번째 테이블은 첫 번째 테이블의 선택에 따라 비동기적으로 업데이트 됩니다.The second table is updated asynchronously based on the selection in the first table. 주문 요약 테이블에서 정렬 및 페이징 작업 부분 업데이트를 발생 합니다.The sorting and paging operations in the orders summary table also cause partial updates.

<%@ 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>
<%@ 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 GridView1_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
        SqlDataSource2.SelectParameters("OrderID").DefaultValue = _
        GridView1.SelectedDataKey.Value.ToString()
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server" />
            <asp:UpdatePanel ID="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>

UpdatePanel 컨트롤 내에 GridView 컨트롤을 배치 하는 경우 GridView 컨트롤의 EnableSortingAndPagingCallbacks 속성을 true로 설정 하는 것은 지원 되지 않습니다.If you put a GridView control inside an UpdatePanel control, setting the GridView control's EnableSortingAndPagingCallbacks property to true is not supported. 그러나 UpdatePanel 컨트롤은 비동기 포스트백을 지원 하므로 UpdatePanel 컨트롤 내에서 GridView 컨트롤을 변경 하는 포스트백은 정렬 및 페이징 콜백과 동일한 동작을 발생 시킵니다.However, because the UpdatePanel control supports asynchronous postbacks, any postbacks that change the GridView control inside an UpdatePanel control cause the same behavior as sorting and paging callbacks.

템플릿에서 UpdatePanel 컨트롤 사용Using an UpdatePanel Control in a Template

다음 예제에서는 GridView 컨트롤의 항목 템플릿에서 UpdatePanel 컨트롤을 사용 합니다.In the following example, an UpdatePanel control is used in the item template of a GridView control. 각 데이터 행의 UpdatePanel 컨트롤은 자동으로 생성 됩니다.UpdatePanel controls in each data row are generated automatically. 각 행의 UpdatePanel 컨트롤에는 해당 행에 항목의 수량을 표시 하는 Label 컨트롤과 수량을 줄이고 높이는 Button 컨트롤이 포함 되어 있습니다.Each row's UpdatePanel control contains a Label control to display the quantity of the item in that row and a Button control to decrease and increase the quantity.


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

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

    Private Sub ChangeQuantity(ByVal Sender As Button, ByVal delta As Integer)
        Dim quantityLabel As Label = CType(Sender.FindControl("QuantityLabel"), Label)
        Dim currentQuantity As Integer = Int32.Parse(quantityLabel.Text)
        currentQuantity = Math.Max(0, currentQuantity + delta)
        quantityLabel.Text = currentQuantity.ToString(System.Globalization.CultureInfo.InvariantCulture)
    End Sub

    Private Sub OnDecreaseQuantity(ByVal Sender As Object, ByVal E As EventArgs)
        ChangeQuantity(Sender, -1)
    End Sub

    Private Sub OnIncreaseQuantity(ByVal Sender As Object, ByVal E As EventArgs)
        ChangeQuantity(Sender, 1)
    End Sub

    Protected Sub Button1_Click(ByVal Sender As Object, ByVal E As EventArgs)
    
        Dim sb As New StringBuilder()
        sb.Append("Beverage order:<br/>")
        For Each row As GridViewRow In GridView1.Rows
        
            If row.RowType = DataControlRowType.DataRow Then
                Dim quantityLabel As Label = CType(row.FindControl("QuantityLabel"), Label)
                Dim currentQuantity As Int32 = Int32.Parse(quantityLabel.Text)
                sb.Append(row.Cells(0).Text + " : " & currentQuantity & "<br/>")
            End If
        Next
        SummaryLabel.Text = sb.ToString()

    End Sub
</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"
                                             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" 
                             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>

설명

이 항목의 내용:In this topic:

소개Introduction

UpdatePanel 컨트롤은 ASP.NET에서 AJAX 기능의 중심 부분입니다.UpdatePanel controls are a central part of AJAX functionality in ASP.NET. 부분 페이지 렌더링을 사용 하는 ScriptManager 컨트롤과 함께 사용 됩니다.They are used with the ScriptManager control to enable partial-page rendering. 부분 페이지 렌더링 페이지의 일부만 업데이트 해야 하는 경우 동기 포스트백 및 전체 페이지 업데이트가 필요를 줄여 줍니다.Partial-page rendering reduces the need for synchronous postbacks and complete page updates when only part of the page has to be updated. 전체 페이지 포스트백 중에 발생 하 고 웹 페이지 상호 작용을 개선 하는 화면 깜박임을 줄어들기 때문에 사용자 환경을 개선 하는 부분 페이지 렌더링 합니다.Partial-page rendering improves the user experience because it reduces the screen flicker that occurs during a full-page postback and improves Web page interactivity.

UpdatePanel 콘텐츠를 새로 고치는 중Refreshing UpdatePanel Content

부분 페이지 렌더링을 사용 하는 경우 컨트롤은 하나 이상의 UpdatePanel 컨트롤의 콘텐츠를 업데이트 하는 비동기 포스트백 또는 전체 페이지를 업데이트 하는 포스트백을 수행할 수 있습니다.When partial-page rendering is enabled, a control can perform a postback that updates the whole page or an asynchronous postback that updates the content of one or more UpdatePanel controls. 컨트롤이 비동기 포스트백을 발생 시키고 UpdatePanel 컨트롤을 업데이트 하는지 여부는 다음에 따라 달라 집니다.Whether a control causes an asynchronous postback and updates an UpdatePanel control depends on the following:

  • UpdatePanel 컨트롤의 UpdateMode 속성이 Always으로 설정 된 경우 페이지에서 발생 하는 모든 포스트백에서 UpdatePanel 컨트롤의 내용이 업데이트 됩니다.If the UpdateMode property of the UpdatePanel control is set to Always, the UpdatePanel control's content is updated on every postback that originates from the page. 여기에는 다른 UpdatePanel 컨트롤 내에 있는 컨트롤의 비동기 포스트백과 UpdatePanel 컨트롤 내에 없는 컨트롤의 포스트백이 포함 됩니다.This includes asynchronous postbacks from controls that are inside other UpdatePanel controls and postbacks from controls that are not inside UpdatePanel controls.

  • UpdateMode 속성이 Conditional로 설정 된 경우 다음과 같은 상황에서 UpdatePanel 컨트롤의 내용이 업데이트 됩니다.If the UpdateMode property is set to Conditional, the UpdatePanel control's content is updated in the following circumstances:

    • UpdatePanel 컨트롤의 Update 메서드를 명시적으로 호출 하는 경우When you call the Update method of the UpdatePanel control explicitly.

    • UpdatePanel 컨트롤이 다른 UpdatePanel 컨트롤 내에 중첩 되 면 부모 패널이 업데이트 됩니다.When the UpdatePanel control is nested inside another UpdatePanel control, and the parent panel is updated.

    • UpdatePanel 컨트롤의 Triggers 속성을 사용 하 여 트리거로 정의 된 컨트롤에 의해 포스트백이 발생 한 경우When a postback is caused by a control that is defined as a trigger by using the Triggers property of the UpdatePanel control. 이 시나리오에서는 컨트롤을 명시적으로 패널 콘텐츠의 업데이트를 트리거합니다.In this scenario, the control explicitly triggers an update of the panel content. 컨트롤은 트리거와 연결 된 UpdatePanel 컨트롤의 내부 또는 외부에 있을 수 있습니다.The control can be either inside or outside the UpdatePanel control that the trigger is associated with.

    • ChildrenAsTriggers 속성이 true로 설정 되 고 UpdatePanel 컨트롤의 자식 컨트롤이 포스트백을 발생 시킵니다.When the ChildrenAsTriggers property is set to true and a child control of the UpdatePanel control causes a postback. 중첩 된 UpdatePanel 컨트롤의 자식 컨트롤은 트리거로 명시적으로 정의 되지 않은 경우 외부 UpdatePanel 컨트롤에 대 한 업데이트를 발생 시 키 지 않습니다.Child controls of nested UpdatePanel controls do not cause an update to the outer UpdatePanel control unless they are explicitly defined as triggers.

ChildrenAsTriggers 속성을 false로 설정 하 고 UpdateMode 속성을 Always로 설정 하는 조합은 허용 되지 않으며 예외를 throw 합니다.The combination of setting the ChildrenAsTriggers property to false and the UpdateMode property to Always is not allowed and will throw an exception.

UpdatePanel 컨트롤은 비동기 게시를 수행할 때 사용자 지정 HTTP 헤더를 추가 합니다.When the UpdatePanel control performs an asynchronous post, it adds a custom HTTP header. 일부 프록시는이 사용자 지정 HTTP 헤더를 제거합니다.Some proxies remove this custom HTTP header. 이 경우 서버 클라이언트 오류가 발생 하는 일반적인 포스트백으로 요청을 처리 합니다.If this occurs, the server handles the request as a regular postback, which causes a client error. 이 문제를 해결 하려면 비동기 게시를 수행할 때 사용자 지정 양식 필드에 삽입 합니다.To resolve this issue, insert a custom form field when you perform asynchronous posts. 헤더 또는 서버 코드에서 사용자 지정 양식 필드를 확인 합니다.Then check the header or the custom form field in server code.

UpdatePanel 사용UpdatePanel Usage

여러 UpdatePanel 컨트롤을 사용 하 여 여러 페이지 영역을 개별적으로 업데이트할 수 있습니다.You can use multiple UpdatePanel controls to update multiple page regions independently. 하나 이상의 UpdatePanel 컨트롤을 포함 하는 페이지가 처음 렌더링 되 면 모든 UpdatePanel 컨트롤의 내용이 렌더링 되어 브라우저로 전송 됩니다.When the page that contains one or more UpdatePanel controls is first rendered, all the content of all UpdatePanel controls are rendered and sent to the browser. 이후 비동기 포스트백에서 각 UpdatePanel 컨트롤의 콘텐츠는 패널 설정 및 개별 패널의 클라이언트 또는 서버 논리에 따라 업데이트 되지 않을 수 있습니다.On subsequent asynchronous postbacks, the content of each UpdatePanel control might not be updated depending on the panel settings and on client or server logic for individual panels.

다음에 대 한 UpdatePanel 컨트롤을 사용할 수도 있습니다.You can also use UpdatePanel controls for the following:

  • 사용자를 제어 합니다.In user controls.

  • 마스터 및 콘텐츠 페이지입니다.On master and content pages.

  • 다른 UpdatePanel 컨트롤 내부에 중첩 됩니다.Nested inside other UpdatePanel controls.

  • GridView 또는 Repeater 컨트롤과 같은 템플릿 기반 컨트롤 내부.Inside templated controls such as the GridView or Repeater controls.

UpdatePanel 컨트롤은 선언적으로 나 프로그래밍 방식으로 추가할 수 있습니다.UpdatePanel controls can be added declaratively or programmatically.

UpdatePanel 컨트롤을 프로그래밍 방식으로 추가할 수 있지만 프로그래밍 방식으로 트리거를 추가할 수는 없습니다.You can add an UpdatePanel control programmatically, but you cannot add triggers programmatically. 트리거 같은 동작을 만들려면 비동기 포스트백 컨트롤로 페이지의 컨트롤을 등록할 수 있습니다.To create trigger-like behavior, you can register a control on the page as an asynchronous postback control. ScriptManager 컨트롤의 RegisterAsyncPostBackControl 메서드를 호출 하 여이 작업을 수행 합니다.You do this by calling the RegisterAsyncPostBackControl method of the ScriptManager control. 그런 다음 비동기 포스트백에 대 한 응답으로 실행 되는 이벤트 처리기를 만들고 처리기에서 UpdatePanel 컨트롤의 Update 메서드를 호출할 수 있습니다.You can then create an event handler that runs in response to the asynchronous postback, and in the handler, call the Update method of the UpdatePanel control.

스타일 적용Applying Styles

UpdatePanel 컨트롤은 expando 특성을 허용 합니다.The UpdatePanel control accepts expando attributes. 이렇게 하면 컨트롤에서 렌더링 하는 HTML 요소에 대 한 CSS 클래스를 설정할 수 있습니다.This lets you set a CSS class for the HTML elements that the controls render. 예를 들어, 다음 예제 에서처럼 태그를 만들 수 있습니다.For example, you might create the markup shown in the following example:

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

이전 예제에서 태그 페이지를 실행할 때 다음과 유사한 HTML을 렌더링 합니다.The markup in the previous example renders HTML similar to the following when the page runs:

<div id="ctl00_MainContent_UpdatePanel1" class="MyStyle">  
</div>  

선언 구문Declarative 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>  

생성자

UpdatePanel()

UpdatePanel 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the UpdatePanel class.

속성

Adapter

컨트롤에 대 한 브라우저별 어댑터를 가져옵니다.Gets the browser-specific adapter for the control.

(다음에서 상속됨 Control)
AppRelativeTemplateSourceDirectory

이 컨트롤이 포함된 Page 또는 UserControl 개체의 애플리케이션 상대 가상 디렉터리를 가져오거나 설정합니다.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(다음에서 상속됨 Control)
Attributes

UpdatePanel 컨트롤의 CSS(CSS 스타일시트) 특성 컬렉션을 가져옵니다.Gets the cascading style sheet (CSS) attributes collection of the UpdatePanel control.

BindingContainer

이 컨트롤의 데이터 바인딩이 포함 된 컨트롤을 가져옵니다.Gets the control that contains this control's data binding.

(다음에서 상속됨 Control)
ChildControlsCreated

서버 컨트롤의 자식 컨트롤을 만든 적이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the server control's child controls have been created.

(다음에서 상속됨 Control)
ChildrenAsTriggers

UpdatePanel 컨트롤의 직계 자식 컨트롤에서 발생한 다시 게시로 인해 패널의 내용이 업데이트되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether postbacks from immediate child controls of an UpdatePanel control update the panel's content.

ClientID

ASP.NET에서 생성하는 HTML 태그의 컨트롤 ID를 가져옵니다.Gets the control ID for HTML markup that is generated by ASP.NET.

(다음에서 상속됨 Control)
ClientIDMode

ClientID 속성의 값을 생성하는 데 사용되는 알고리즘을 가져오거나 설정합니다.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(다음에서 상속됨 Control)
ClientIDSeparator

ClientID 속성에 사용된 구분 문자를 나타내는 문자 값을 가져옵니다.Gets a character value representing the separator character used in the ClientID property.

(다음에서 상속됨 Control)
ContentTemplate

UpdatePanel 컨트롤의 내용을 정의하는 템플릿을 가져오거나 설정합니다.Gets or sets the template that defines the content of the UpdatePanel control.

ContentTemplateContainer

자식 컨트롤을 프로그래밍 방식으로 추가할 수 있는 컨트롤 개체를 가져옵니다.Gets a control object to which you can programmatically add child controls.

Context

현재 웹 요청에 대한 서버 컨트롤과 관련된 HttpContext 개체를 가져옵니다.Gets the HttpContext object associated with the server control for the current Web request.

(다음에서 상속됨 Control)
Controls

ControlCollection 컨트롤의 자식 컨트롤이 들어 있는 UpdatePanel 개체를 가져옵니다.Gets the ControlCollection object that contains the child controls for the UpdatePanel control.

DataItemContainer

명명 컨테이너가 IDataItemContainer를 구현할 경우 명명 컨테이너에 대한 참조를 가져옵니다.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(다음에서 상속됨 Control)
DataKeysContainer

명명 컨테이너가 IDataKeysControl를 구현할 경우 명명 컨테이너에 대한 참조를 가져옵니다.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(다음에서 상속됨 Control)
DesignMode

컨트롤을 디자인 화면에서 사용 되 고 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether a control is being used on a design surface.

(다음에서 상속됨 Control)
EnableTheming

이 컨트롤에 테마를 적용할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether themes apply to this control.

(다음에서 상속됨 Control)
EnableViewState

서버 컨트롤이 해당 뷰 상태와 포함하고 있는 모든 자식 컨트롤의 뷰 상태를, 요청하는 클라이언트까지 유지하는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(다음에서 상속됨 Control)
Events

컨트롤에 대 한 이벤트 처리기 대리자의 목록을 가져옵니다.Gets a list of event handler delegates for the control. 이 속성은 읽기 전용입니다.This property is read-only.

(다음에서 상속됨 Control)
HasChildViewState

현재 서버 컨트롤의 자식 컨트롤에 모든 저장 된 뷰 상태 설정 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(다음에서 상속됨 Control)
ID

서버 컨트롤에 할당된 프로그래밍 ID를 가져오거나 설정합니다.Gets or sets the programmatic identifier assigned to the server control.

(다음에서 상속됨 Control)
IdSeparator

컨트롤 식별자를 구분 하는 데 사용 하는 문자를 가져옵니다.Gets the character used to separate control identifiers.

(다음에서 상속됨 Control)
IsChildControlStateCleared

이 컨트롤에 포함 된 컨트롤 컨트롤 상태를 가지는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether controls contained within this control have control state.

(다음에서 상속됨 Control)
IsInPartialRendering

비동기 포스트백의 결과로 UpdatePanel 컨트롤이 업데이트되고 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the UpdatePanel control is being updated as a result of an asynchronous postback.

IsTrackingViewState

서버 컨트롤이 해당 뷰 상태의 변경 내용을 저장 하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the server control is saving changes to its view state.

(다음에서 상속됨 Control)
IsViewStateEnabled

이 컨트롤에 대 한 보기 상태 사용 되는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether view state is enabled for this control.

(다음에서 상속됨 Control)
LoadViewStateByID

인덱스 대신 ID별로 뷰 상태를 로드할 때 컨트롤이 참여하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(다음에서 상속됨 Control)
NamingContainer

동일한 ID 속성 값을 사용하는 서버 컨트롤을 구별하기 위해 고유의 네임스페이스를 만드는 서버 컨트롤의 명명 컨테이너에 대한 참조를 가져옵니다.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(다음에서 상속됨 Control)
Page

서버 컨트롤이 들어 있는 Page 인스턴스에 대한 참조를 가져옵니다.Gets a reference to the Page instance that contains the server control.

(다음에서 상속됨 Control)
Parent

페이지 컨트롤 계층 구조에서 서버 컨트롤의 부모 컨트롤에 대 한 참조를 가져옵니다.Gets a reference to the server control's parent control in the page control hierarchy.

(다음에서 상속됨 Control)
RenderingCompatibility

ASP.NET 버전을 렌더링 된 HTML이 호환 될 지정 하는 값을 가져옵니다.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(다음에서 상속됨 Control)
RenderMode

UpdatePanel 컨트롤의 내용이 HTML <div> 또는 <span> 요소로 묶이는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether an UpdatePanel control's content is enclosed in an HTML <div> or <span> element.

RequiresUpdate

UpdatePanel 컨트롤의 내용이 업데이트될지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the content of the UpdatePanel control will be updated.

Site

디자인 화면에서 렌더링 될 때 현재 컨트롤을 호스팅하는 컨테이너에 대 한 정보를 가져옵니다.Gets information about the container that hosts the current control when rendered on a design surface.

(다음에서 상속됨 Control)
SkinID

컨트롤에 적용할 스킨을 가져오거나 설정합니다.Gets or sets the skin to apply to the control.

(다음에서 상속됨 Control)
TemplateControl

이 컨트롤이 포함 된 서식 파일에 대 한 참조를 가져오거나 설정 합니다.Gets or sets a reference to the template that contains this control.

(다음에서 상속됨 Control)
TemplateSourceDirectory

Page 또는 현재 서버 컨트롤이 들어 있는 UserControl의 가상 디렉터리를 가져옵니다.Gets the virtual directory of the Page or UserControl that contains the current server control.

(다음에서 상속됨 Control)
Triggers

UpdatePanelTriggerCollection 컨트롤에 선언적으로 등록된 AsyncPostBackTriggerPostBackTrigger 개체를 포함하는 UpdatePanel 개체를 가져옵니다.Gets an UpdatePanelTriggerCollection object that contains AsyncPostBackTrigger and PostBackTrigger objects that were registered declaratively for the UpdatePanel control.

UniqueID

서버 컨트롤에 대 한 고유 계층적으로 정규화 된 식별자를 가져옵니다.Gets the unique, hierarchically qualified identifier for the server control.

(다음에서 상속됨 Control)
UpdateMode

UpdatePanel 컨트롤의 내용이 업데이트되는 시점을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates when an UpdatePanel control's content is updated.

ValidateRequestMode

컨트롤에서 잠재적으로 위험한 값에 대 한 브라우저의에서 클라이언트 입력을 확인 하는지 여부를 나타내는 값을 가져오거나 설정 합니다.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(다음에서 상속됨 Control)
ViewState

저장 하 고 동일한 페이지에 대 한 여러 요청에서 서버 컨트롤의 뷰 상태를 복원할 수 있는 상태 정보 사전을 가져옵니다.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(다음에서 상속됨 Control)
ViewStateIgnoresCase

StateBag 개체가 대/소문자를 구분하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the StateBag object is case-insensitive.

(다음에서 상속됨 Control)
ViewStateMode

이 컨트롤의 뷰 상태 모드를 가져오거나 설정 합니다.Gets or sets the view-state mode of this control.

(다음에서 상속됨 Control)
Visible

페이지에서 서버 컨트롤이 UI로 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(다음에서 상속됨 Control)

메서드

AddedControl(Control, Int32)

자식 컨트롤이 Controls 개체의 Control 컬렉션에 추가된 후 호출됩니다.Called after a child control is added to the Controls collection of the Control object.

(다음에서 상속됨 Control)
AddParsedSubObject(Object)

XML 또는 HTML 요소가 구문 분석되었음을 서버 컨트롤에 알리고 서버 컨트롤의 ControlCollection 개체에 요소를 추가합니다.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(다음에서 상속됨 Control)
ApplyStyleSheetSkin(Page)

컨트롤에 페이지 스타일 시트에 정의 된 스타일 속성을 적용 합니다.Applies the style properties defined in the page style sheet to the control.

(다음에서 상속됨 Control)
BeginRenderTracing(TextWriter, Object)

렌더링 데이터의 디자인 타임 추적을 시작합니다.Begins design-time tracing of rendering data.

(다음에서 상속됨 Control)
BuildProfileTree(String, Boolean)

서버 컨트롤에 대한 정보를 수집하고, 페이지에 대해 추적이 활성화된 경우 표시할 Trace 속성에 이 정보를 전달합니다.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(다음에서 상속됨 Control)
ClearCachedClientID()

캐시된 ClientID 값을 null로 설정합니다.Sets the cached ClientID value to null.

(다음에서 상속됨 Control)
ClearChildControlState()

서버 컨트롤의 자식 컨트롤의 컨트롤 상태 정보를 삭제합니다.Deletes the control-state information for the server control's child controls.

(다음에서 상속됨 Control)
ClearChildState()

서버 컨트롤의 모든 자식 컨트롤의 뷰 상태 및 컨트롤 상태 정보를 삭제합니다.Deletes the view-state and control-state information for all the server control's child controls.

(다음에서 상속됨 Control)
ClearChildViewState()

서버 컨트롤의 모든 자식 컨트롤의 뷰 상태 정보가 삭제 됩니다.Deletes the view-state information for all the server control's child controls.

(다음에서 상속됨 Control)
ClearEffectiveClientIDMode()

현재 컨트롤 인스턴스 및 자식 컨트롤의 ClientIDMode 속성을 Inherit로 설정합니다.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(다음에서 상속됨 Control)
CreateChildControls()

다시 게시 또는 렌더링하기 위한 준비 작업으로, 포함된 자식 컨트롤을 만들도록 컴퍼지션 기반 구현을 사용하는 서버 컨트롤에 알리기 위해 ASP.NET 페이지 프레임워크에 의해 호출됩니다.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(다음에서 상속됨 Control)
CreateContentTemplateContainer()

Control 컨트롤의 내용을 정의하는 자식 컨트롤의 컨테이너 역할을 하는 UpdatePanel 개체를 만듭니다.Creates a Control object that acts as a container for child controls that define the UpdatePanel control's content.

CreateControlCollection()

UpdatePanel 컨트롤에 포함된 모든 컨트롤의 컬렉션을 반환합니다.Returns the collection of all controls contained in the UpdatePanel control.

DataBind()

호출된 서버 컨트롤과 모든 해당 자식 컨트롤에 데이터 원본을 바인딩합니다.Binds a data source to the invoked server control and all its child controls.

(다음에서 상속됨 Control)
DataBind(Boolean)

DataBinding 이벤트를 발생시키는 옵션을 사용하여, 호출된 서버 컨트롤과 모든 자식 컨트롤에 데이터 소스를 바인딩합니다.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(다음에서 상속됨 Control)
DataBindChildren()

서버 컨트롤의 자식 컨트롤에 데이터 소스를 바인딩합니다.Binds a data source to the server control's child controls.

(다음에서 상속됨 Control)
Dispose()

메모리에서 해제 되기 전에 최종 정리를 수행 하는 서버 컨트롤을 사용 하도록 설정 합니다.Enables a server control to perform final clean up before it is released from memory.

(다음에서 상속됨 Control)
EndRenderTracing(TextWriter, Object)

렌더링 데이터의 디자인 타임 추적을 종료합니다.Ends design-time tracing of rendering data.

(다음에서 상속됨 Control)
EnsureChildControls()

서버 컨트롤에 자식 컨트롤이 있는지 여부를 결정 합니다.Determines whether the server control contains child controls. 그렇지 않은 경우 해당 자식 컨트롤을 만듭니다.If it does not, it creates child controls.

(다음에서 상속됨 Control)
EnsureID()

Id가 할당 되지 않은 컨트롤에 대 한 식별자를 만듭니다.Creates an identifier for controls that do not have an identifier assigned.

(다음에서 상속됨 Control)
Equals(Object)

지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
FindControl(String)

지정된 id 매개 변수를 사용하여 서버 컨트롤의 현재 명명 컨테이너를 검색합니다.Searches the current naming container for a server control with the specified id parameter.

(다음에서 상속됨 Control)
FindControl(String, Int32)

현재 명명 컨테이너에서 특정 id와 함께 pathOffset 매개 변수에 지정된 검색용 정수를 사용하여 서버 컨트롤을 검색합니다.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. 이 버전의 FindControl 메서드를 재정의해서는 안됩니다.You should not override this version of the FindControl method.

(다음에서 상속됨 Control)
Focus()

컨트롤에 입력 포커스를 설정합니다.Sets input focus to a control.

(다음에서 상속됨 Control)
GetDesignModeState()

컨트롤에 대 한 디자인 타임 데이터를 가져옵니다.Gets design-time data for a control.

(다음에서 상속됨 Control)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetRouteUrl(Object)

경로 매개 변수 집합에 해당 하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters.

(다음에서 상속됨 Control)
GetRouteUrl(RouteValueDictionary)

경로 매개 변수 집합에 해당 하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters.

(다음에서 상속됨 Control)
GetRouteUrl(String, Object)

경로 이름과 경로 매개 변수 집합에 해당 하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters and a route name.

(다음에서 상속됨 Control)
GetRouteUrl(String, RouteValueDictionary)

경로 이름과 경로 매개 변수 집합에 해당 하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters and a route name.

(다음에서 상속됨 Control)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
GetUniqueIDRelativeTo(Control)

지정된 컨트롤의 UniqueID 속성에서 접두사 부분을 반환합니다.Returns the prefixed portion of the UniqueID property of the specified control.

(다음에서 상속됨 Control)
HasControls()

서버 컨트롤에 자식 컨트롤이 경우를 결정 합니다.Determines if the server control contains any child controls.

(다음에서 상속됨 Control)
HasEvents()

이벤트 컨트롤이 나 자식 컨트롤에 등록 되었는지 여부를 나타내는 값을 반환 합니다.Returns a value indicating whether events are registered for the control or any child controls.

(다음에서 상속됨 Control)
Initialize()

부분 페이지 렌더링을 사용하도록 설정한 경우 UpdatePanel 컨트롤 트리거 컬렉션을 초기화합니다.Initializes the UpdatePanel control trigger collection if partial-page rendering is enabled.

IsLiteralContent()

서버 컨트롤에 리터럴 내용만 저장 하는 경우를 결정 합니다.Determines if the server control holds only literal content.

(다음에서 상속됨 Control)
LoadControlState(Object)

SaveControlState() 메서드에서 저장한 이전 페이지 요청에서 컨트롤 상태 정보를 복원합니다.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(다음에서 상속됨 Control)
LoadViewState(Object)

SaveViewState() 메서드로 저장한 이전 페이지 요청에서 뷰 상태 정보를 복원합니다.Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(다음에서 상속됨 Control)
MapPathSecure(String)

절대 또는 상대 가상 경로 매핑되는 실제 경로 검색 합니다.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(다음에서 상속됨 Control)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
OnBubbleEvent(Object, EventArgs)

서버 컨트롤의 이벤트가 페이지의 UI 서버 컨트롤 계층 구조에 전달되었는지 여부를 확인합니다.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(다음에서 상속됨 Control)
OnDataBinding(EventArgs)

DataBinding 이벤트를 발생시킵니다.Raises the DataBinding event.

(다음에서 상속됨 Control)
OnInit(EventArgs)

Init 이벤트를 발생시킵니다.Raises the Init event.

OnLoad(EventArgs)

부분 페이지 렌더링이 사용되지 않는 경우 Load 컨트롤의 UpdatePanel 이벤트를 발생시키고 Initialize() 메서드를 호출합니다.Raises the Load event for the UpdatePanel control and invokes the Initialize() method when partial-page rendering is not enabled.

OnPreRender(EventArgs)

PreRender 이벤트를 발생시킵니다.Raises the PreRender event.

OnUnload(EventArgs)

기본 Unload 이벤트를 발생시킵니다.Raises the base Unload event.

OpenFile(String)

파일을 읽는 데 사용되는 Stream을 가져옵니다.Gets a Stream used to read a file.

(다음에서 상속됨 Control)
RaiseBubbleEvent(Object, EventArgs)

이벤트 및 해당 정보의 소스 컨트롤의 부모를 할당 합니다.Assigns any sources of the event and its information to the control's parent.

(다음에서 상속됨 Control)
RemovedControl(Control)

자식 컨트롤이 Controls 개체의 Control 컬렉션에서 제거된 후 호출됩니다.Called after a child control is removed from the Controls collection of the Control object.

(다음에서 상속됨 Control)
Render(HtmlTextWriter)

Render(HtmlTextWriter) 이벤트를 발생시킵니다.Raises the Render(HtmlTextWriter) event.

RenderChildren(HtmlTextWriter)

RenderChildren(HtmlTextWriter) 이벤트를 발생시킵니다.Raises the RenderChildren(HtmlTextWriter) event.

RenderControl(HtmlTextWriter)

제공된 HtmlTextWriter 개체로 서버 컨트롤 콘텐츠를 출력하고 추적을 사용하는 경우 컨트롤에 대한 추적 정보를 저장합니다.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(다음에서 상속됨 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

제공된 HtmlTextWriter 개체를 사용하여 제공된 ControlAdapter 개체에 서버 컨트롤 콘텐츠를 출력합니다.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(다음에서 상속됨 Control)
ResolveAdapter()

지정된 된 컨트롤을 렌더링 하는 컨트롤 어댑터를 가져옵니다.Gets the control adapter responsible for rendering the specified control.

(다음에서 상속됨 Control)
ResolveClientUrl(String)

브라우저에서 사용할 수 있는 URL을 가져옵니다.Gets a URL that can be used by the browser.

(다음에서 상속됨 Control)
ResolveUrl(String)

URL을 요청 하는 클라이언트에서 사용할 수 있는 변환 합니다.Converts a URL into one that is usable on the requesting client.

(다음에서 상속됨 Control)
SaveControlState()

페이지가 서버에 다시 게시된 후 발생한 서버 컨트롤 상태의 변경을 저장합니다.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(다음에서 상속됨 Control)
SaveViewState()

페이지가 서버에 다시 게시된 이후 발생한 서버 컨트롤 뷰 상태의 변경을 저장합니다.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(다음에서 상속됨 Control)
SetDesignModeState(IDictionary)

컨트롤에 대한 디자인 타임 데이터를 설정합니다.Sets design-time data for a control.

(다음에서 상속됨 Control)
SetRenderMethodDelegate(RenderMethod)

서버 컨트롤 및 해당 콘텐츠를 부모 컨트롤로 렌더링 하는 이벤트 처리기 대리자를 할당 합니다.Assigns an event handler delegate to render the server control and its content into its parent control.

(다음에서 상속됨 Control)
SetTraceData(Object, Object)

디자인 타임 렌더링 데이터의 추적, 추적 데이터 키와 추적 데이터 값을 사용 하 여에 대 한 데이터를 추적 하는 설정 합니다.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(다음에서 상속됨 Control)
SetTraceData(Object, Object, Object)

디자인 타임 렌더링 데이터의 추적, 추적 된 개체, 추적 데이터 키와 추적 데이터 값을 사용 하 여에 대 한 데이터를 추적 하는 설정 합니다.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(다음에서 상속됨 Control)
ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TrackViewState()

서버 컨트롤의 뷰 상태 변경 사항 추적 작업을 실행하여 서버 컨트롤의 StateBag 개체에 변경 사항이 저장되도록 합니다.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. 이 개체는 ViewState 속성을 통해 액세스할 수 있습니다.This object is accessible through the ViewState property.

(다음에서 상속됨 Control)
Update()

UpdatePanel 컨트롤의 내용을 업데이트합니다.Causes an update of the content of an UpdatePanel control.

이벤트

DataBinding

서버 컨트롤을 데이터 소스에 바인딩할 때 발생 합니다.Occurs when the server control binds to a data source.

(다음에서 상속됨 Control)
Disposed

서버 컨트롤은 ASP.NET 페이지가 요청 될 때 서버 컨트롤 주기의 마지막 단계는 메모리에서 해제 될 때 발생 합니다.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(다음에서 상속됨 Control)
Init

서버 컨트롤 주기의 첫 번째 단계는 초기화 될 때 발생 합니다.Occurs when the server control is initialized, which is the first step in its lifecycle.

(다음에서 상속됨 Control)
Load

Page 개체에 서버 컨트롤을 로드할 때 발생합니다.Occurs when the server control is loaded into the Page object.

(다음에서 상속됨 Control)
PreRender

Control 개체가 로드된 후, 렌더링 전에 발생합니다.Occurs after the Control object is loaded but prior to rendering.

(다음에서 상속됨 Control)
Unload

서버 컨트롤이 메모리에서 언로드될 때 발생 합니다.Occurs when the server control is unloaded from memory.

(다음에서 상속됨 Control)

명시적 인터페이스 구현

IAttributeAccessor.GetAttribute(String)

지정된 된 이름을 사용 하 여 웹 컨트롤의 특성을 반환 합니다.Returns an attribute of a Web control by using a specified name.

IAttributeAccessor.SetAttribute(String, String)

지정된 된 컨트롤 특성의 값을 설정 합니다.Sets the value of the specified control attribute.

IControlBuilderAccessor.ControlBuilder

이 멤버에 대한 설명은 ControlBuilder를 참조하세요.For a description of this member, see ControlBuilder.

(다음에서 상속됨 Control)
IControlDesignerAccessor.GetDesignModeState()

이 멤버에 대한 설명은 GetDesignModeState()를 참조하세요.For a description of this member, see GetDesignModeState().

(다음에서 상속됨 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

이 멤버에 대한 설명은 SetDesignModeState(IDictionary)를 참조하세요.For a description of this member, see SetDesignModeState(IDictionary).

(다음에서 상속됨 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

이 멤버에 대한 설명은 SetOwnerControl(Control)를 참조하세요.For a description of this member, see SetOwnerControl(Control).

(다음에서 상속됨 Control)
IControlDesignerAccessor.UserData

이 멤버에 대한 설명은 UserData를 참조하세요.For a description of this member, see UserData.

(다음에서 상속됨 Control)
IDataBindingsAccessor.DataBindings

이 멤버에 대한 설명은 DataBindings를 참조하세요.For a description of this member, see DataBindings.

(다음에서 상속됨 Control)
IDataBindingsAccessor.HasDataBindings

이 멤버에 대한 설명은 HasDataBindings를 참조하세요.For a description of this member, see HasDataBindings.

(다음에서 상속됨 Control)
IExpressionsAccessor.Expressions

이 멤버에 대한 설명은 Expressions를 참조하세요.For a description of this member, see Expressions.

(다음에서 상속됨 Control)
IExpressionsAccessor.HasExpressions

이 멤버에 대한 설명은 HasExpressions를 참조하세요.For a description of this member, see HasExpressions.

(다음에서 상속됨 Control)
IParserAccessor.AddParsedSubObject(Object)

이 멤버에 대한 설명은 AddParsedSubObject(Object)를 참조하세요.For a description of this member, see AddParsedSubObject(Object).

(다음에서 상속됨 Control)

확장 메서드

FindDataSourceControl(Control)

지정된 컨트롤에 대한 데이터 컨트롤에 연결된 데이터 소스를 반환합니다.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

지정된 컨트롤의 명명 컨테이너에서 지정된 열에 대한 필드 템플릿을 반환합니다.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

상위 데이터 컨트롤에 대한 메타테이블 개체를 반환합니다.Returns the metatable object for the containing data control.

적용 대상

추가 정보