다음을 통해 공유

AsyncPostBackTrigger 클래스

  • 참조

정의

네임스페이스:
System.Web.UI
어셈블리:
System.Web.Extensions.dll

컨트롤 및 컨트롤의 선택적 이벤트를 UpdatePanel 컨트롤을 새로 고치는 비동기 포스트백 컨트롤 트리거로 정의합니다.

public ref class AsyncPostBackTrigger : System::Web::UI::UpdatePanelControlTrigger
public class AsyncPostBackTrigger : System.Web.UI.UpdatePanelControlTrigger
type AsyncPostBackTrigger = class
    inherit UpdatePanelControlTrigger
Public Class AsyncPostBackTrigger
Inherits UpdatePanelControlTrigger
상속
Object
UpdatePanelTrigger
UpdatePanelControlTrigger
AsyncPostBackTrigger

예제

다음 예제에서는 추가 하는 방법을 보여 줍니다는 AsyncPostBackTrigger 선언적으로 제어 합니다. Button 외부에 있는 컨트롤을 UpdatePanel 컨트롤에서 찾을 검색어를 입력 하는 사용자가 수는 Products Northwind 데이터베이스의 테이블입니다. A GridView 내에 있는 컨트롤을 UpdatePanel 컨트롤 결과 보여 줍니다. 합니다 Button 컨트롤에 대 한 비동기 트리거로 지정는 UpdatePanel 제어 합니다.

<%@ 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 Button1_Click(object sender, EventArgs e)
    {
        SqlDataSource1.SelectParameters["SearchTerm"].DefaultValue = 
            Server.HtmlEncode(TextBox1.Text);
        Label1.Text = "Searching for '" + 
            Server.HtmlEncode(TextBox1.Text) + "'";
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>AsyncPostBackTrigger Example</title>
</head>
<body>
    <form id="form1" defaultbutton="Button1"
          defaultfocus="TextBox1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" runat="server" />
            <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
            <asp:Button ID="Button1" Text="Submit" 
                        OnClick="Button1_Click" runat="server"  />
            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" 
                             runat="server">
                <Triggers>
                  <asp:AsyncPostBackTrigger ControlID="Button1" />
                </Triggers>
                <ContentTemplate>
                    <hr />
                    <asp:Label ID="Label1" runat="server"/>
                    <br />
                    <asp:GridView ID="GridView1" runat="server" AllowPaging="True"
                        AllowSorting="True"
                        DataSourceID="SqlDataSource1">
                        <EmptyDataTemplate>
                        Enter a search term.
                        </EmptyDataTemplate>
                    </asp:GridView>
                    <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
                        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                        SelectCommand="SELECT [ProductName], [UnitsInStock] FROM 
                        [Alphabetical list of products] WHERE ([ProductName] LIKE 
                        '%' + @SearchTerm + '%')">
                        <SelectParameters>
                            <asp:Parameter Name="SearchTerm" Type="String" />
                        </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 Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        SqlDataSource1.SelectParameters("SearchTerm").DefaultValue = _
            Server.HtmlEncode(TextBox1.Text)
        Label1.Text = "Searching for '" & _
            Server.HtmlEncode(TextBox1.Text) & "'"

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>AsyncPostBackTrigger Example</title>
</head>
<body>
    <form id="form1" defaultbutton="Button1"
          defaultfocus="TextBox1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" runat="server" />
            <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
            <asp:Button ID="Button1" Text="Submit" 
                        OnClick="Button1_Click" runat="server"  />
            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" 
                             runat="server">
                <Triggers>
                  <asp:AsyncPostBackTrigger ControlID="Button1" />
                </Triggers>
                <ContentTemplate>
                    <hr />
                    <asp:Label ID="Label1" runat="server"/>
                    <br />
                    <asp:GridView ID="GridView1" runat="server" AllowPaging="True"
                        AllowSorting="True"
                        DataSourceID="SqlDataSource1">
                        <EmptyDataTemplate>
                        Enter a search term.
                        </EmptyDataTemplate>
                    </asp:GridView>
                    <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
                        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                        SelectCommand="SELECT [ProductName], [UnitsInStock] FROM 
                        [Alphabetical list of products] WHERE ([ProductName] LIKE 
                        '%' + @SearchTerm + '%')">
                        <SelectParameters>
                            <asp:Parameter Name="SearchTerm" Type="String" />
                        </SelectParameters>
                    </asp:SqlDataSource>
                </ContentTemplate>
            </asp:UpdatePanel>
        </div>
    </form>
</body>
</html>

설명

사용 하 여는 AsyncPostBackTrigger 컨트롤에 대 한 트리거를 사용 하도록 설정 하려면 컨트롤을 UpdatePanel 컨트롤입니다. 업데이트 패널에 대 한 트리거는 컨트롤에 대해 비동기 포스트백 후 패널의 콘텐츠 새로 고침을 발생 합니다. 비동기 트리거 컨트롤을 정의 다음과 같은 시나리오에서 유용 합니다.

  • 컨트롤에 대 한 패널 밖에 있는 합니다.

  • 패널 내에 있는 컨트롤에 대 한 경우는 ChildrenAsTriggers 속성은 false합니다.

  • 부모 패널 고치려는 중첩 된 패널 내에 있는 컨트롤입니다.

컨트롤은는 AsyncPostBackTrigger 컨트롤 참조 역할을 하는 트리거 업데이트 패널의 동일한 명명 컨테이너에서 이어야 합니다. 다른 명명 컨테이너에 컨트롤을 기반으로 하는 트리거는 지원 되지 않습니다.

추가 AsyncPostBackTrigger 제어를 사용 하 여는 UpdatePanelTrigger 컬렉션 편집기 대화 상자는 디자이너에서 만들어를 Triggers 요소에서 선언적으로 UpdatePanel 제어 합니다. 합니다 ControlID 속성이 필요 하지만 EventName 속성은 선택 사항입니다. 경우는 EventName 속성을 지정 하지 않으면는 DefaultEventAttribute 특성 컨트롤의 기본 이벤트를 확인 하는 데 사용 됩니다. 예를 들어,에 대 한 기본 이벤트를 Button 컨트롤은는 Click 이벤트입니다. EventName 속성이 대/소문자 구분 합니다.

또한 트리거로 명명 컨테이너를 참조할 수 있습니다. 포스트백을 발생 시키는 컨테이너의 모든 자식 컨트롤에 대 한 트리거 라고 하는 경우에 UpdatePanel 제어 합니다.

프로그래밍 방식으로 추가 AsyncPostBackTrigger 컨트롤은 지원 되지 않습니다. 포스트백 컨트롤을 프로그래밍 방식으로 등록 하려면 사용 합니다 RegisterAsyncPostBackControl 메서드는 ScriptManager 컨트롤입니다. 호출을 Update 메서드의 UpdatePanel 컨트롤이 다시 게시 하는 경우를 제어 합니다.

둘 다를 사용 하는 컨트롤을 정의 하는 경우 PostBackTrigger 고 AsyncPostBackTrigger, 예외가 throw 됩니다.

생성자

AsyncPostBackTrigger()

AsyncPostBackTrigger 클래스의 새 인스턴스를 초기화합니다.

속성

ControlID

UpdatePanel 컨트롤의 비동기 포스트백을 트리거하는 컨트롤의 이름을 가져오거나 설정합니다.
EventName

UpdatePanel 컨트롤을 업데이트하는 포스트백 컨트롤 이벤트를 가져오거나 설정합니다.
Owner

UpdatePanel의 대상이 되는 UpdatePanelTrigger 컨트롤에 대한 참조를 가져옵니다.

(다음에서 상속됨 UpdatePanelTrigger)

메서드

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
FindTargetControl(Boolean)

ControlID 속성에 지정된 컨트롤을 찾습니다.

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

기본 해시 함수로 작동합니다.

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

현재 인스턴스의 Type을 가져옵니다.

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

트리거가 호출되었는지 여부를 나타내는 값을 반환합니다.
Initialize()

AsyncPostBackTrigger 컨트롤을 초기화하고 트리거에 지정된 이벤트가 존재하며 유효한지 확인합니다.
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

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

포스트백을 트리거하고 UpdatePanel 컨트롤을 새로 고치는 이벤트를 발생시킵니다.
ToString()

현재 AsyncPostBackTrigger 컨트롤의 문자열 표현을 반환합니다.

적용 대상

추가 정보