ClientScriptManager.GetPostBackEventReference 메서드

정의

네임스페이스:: System.Web.UI

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다.

오버로드

Name	Description
GetPostBackEventReference(Control, String, Boolean)	서버에 포스트백을 발생시키는 클라이언트 이벤트에서 사용할 문자열을 반환합니다. 참조 문자열은 포스트백 및 추가 이벤트 정보의 문자열 인수를 처리하는 지정된 컨트롤에 의해 정의됩니다. 필요에 따라 유효성 검사를 위해 이벤트 참조를 등록합니다.
GetPostBackEventReference(PostBackOptions, Boolean)	서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다. 참조 문자열은 지정된 개체에 의해 정의됩니다 PostBackOptions . 필요에 따라 유효성 검사를 위해 이벤트 참조를 등록합니다.
GetPostBackEventReference(PostBackOptions)	서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다. 참조 문자열은 지정된 인스턴스에 의해 정의됩니다 PostBackOptions .
GetPostBackEventReference(Control, String)	서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다. 참조 문자열은 포스트백 및 추가 이벤트 정보의 문자열 인수를 처리하는 지정된 컨트롤에 의해 정의됩니다.

GetPostBackEventReference(Control, String, Boolean)

서버에 포스트백을 발생시키는 클라이언트 이벤트에서 사용할 문자열을 반환합니다. 참조 문자열은 포스트백 및 추가 이벤트 정보의 문자열 인수를 처리하는 지정된 컨트롤에 의해 정의됩니다. 필요에 따라 유효성 검사를 위해 이벤트 참조를 등록합니다.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, bool registerForEventValidation);

public string GetPostBackEventReference(System.Web.UI.Control control, string argument, bool registerForEventValidation);

member this.GetPostBackEventReference : System.Web.UI.Control * string * bool -> string

Public Function GetPostBackEventReference (control As Control, argument As String, registerForEventValidation As Boolean) As String

매개 변수

control: Control

서버 Control 에서 포스트백을 처리하는 서버입니다.

argument: String

에 전달할 선택적 인수의 문자열입니다 control.

registerForEventValidation: Boolean

true유효성 검사를 위해 이벤트 참조를 등록하려면 다음을 수행합니다. 그렇지 않으면 . false

반환

String

클라이언트에서 스크립트로 처리될 때 포스트백을 시작하는 문자열입니다.

예외

ArgumentNullException

지정된 Control 값은 .입니다 null.

설명

에 IPostBackEventHandler 대한 인터페이스를 Page구현하려면 지시문을 사용합니다 @ Implements .

이 메서드는 GetPostBackEventReference 속성이 .인 Button 경우 컨트롤과 UseSubmitBehavior 함께 사용할 수 있습니다 false. 이 시나리오에서 메서드는 GetPostBackEventReference 컨트롤에 대한 클라이언트 포스트백 이벤트를 반환합니다 Button .

true이면 registerForEventValidation 메서드를 GetPostBackEventReference(PostBackOptions, Boolean) 호출 RegisterForEventValidation(String, String) 하여 유효성 검사에 대한 이벤트 참조를 이벤트를 생성하는 클라이언트 컨트롤을 나타내는 고유 컨트롤 ID로 등록합니다.

추가 정보

적용 대상

GetPostBackEventReference(PostBackOptions, Boolean)

서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다. 참조 문자열은 지정된 개체에 의해 정의됩니다 PostBackOptions . 필요에 따라 유효성 검사를 위해 이벤트 참조를 등록합니다.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options, bool registerForEventValidation);

public string GetPostBackEventReference(System.Web.UI.PostBackOptions options, bool registerForEventValidation);

member this.GetPostBackEventReference : System.Web.UI.PostBackOptions * bool -> string

Public Function GetPostBackEventReference (options As PostBackOptions, registerForEventValidation As Boolean) As String

매개 변수

options: PostBackOptions

포스트백을 정의하는 A PostBackOptions 입니다.

registerForEventValidation: Boolean

true유효성 검사를 위해 이벤트 참조를 등록하려면 다음을 수행합니다. 그렇지 않으면 . false

반환

String

클라이언트에서 스크립트로 처리될 때 클라이언트 포스트백을 시작하는 문자열입니다.

예외

ArgumentNullException

PostBackOptions은 null입니다.

설명

개체에 IPostBackEventHandler 대한 인터페이스를 Page 구현하려면 지시문을 사용합니다 @ Implements .

이 true경우 registerForEventValidation 메서드는 GetPostBackEventReference(PostBackOptions, Boolean) 메서드를 호출 RegisterForEventValidation(String, String) 하여 유효성 검사에 대한 이벤트 참조를 이벤트를 생성하는 클라이언트 컨트롤을 나타내는 고유 컨트롤 ID로 등록합니다.

추가 정보

적용 대상

GetPostBackEventReference(PostBackOptions)

서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다. 참조 문자열은 지정된 인스턴스에 의해 정의됩니다 PostBackOptions .

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options);

public string GetPostBackEventReference(System.Web.UI.PostBackOptions options);

member this.GetPostBackEventReference : System.Web.UI.PostBackOptions -> string

Public Function GetPostBackEventReference (options As PostBackOptions) As String

매개 변수

options: PostBackOptions

포스트백을 정의하는 A PostBackOptions 입니다.

반환

String

클라이언트에서 스크립트로 처리될 때 클라이언트 포스트백을 시작하는 문자열입니다.

예외

ArgumentNullException

매개 변수는 PostBackOptionsnull

설명

에 IPostBackEventHandler 대한 인터페이스를 Page구현하려면 지시문을 사용합니다 @ Implements .

추가 정보

적용 대상

GetPostBackEventReference(Control, String)

서버에 포스트백을 발생시키는 클라이언트 이벤트에 사용할 수 있는 문자열을 반환합니다. 참조 문자열은 포스트백 및 추가 이벤트 정보의 문자열 인수를 처리하는 지정된 컨트롤에 의해 정의됩니다.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument);

public string GetPostBackEventReference(System.Web.UI.Control control, string argument);

member this.GetPostBackEventReference : System.Web.UI.Control * string -> string

Public Function GetPostBackEventReference (control As Control, argument As String) As String

매개 변수

control: Control

서버 Control 에서 포스트백을 처리하는 서버입니다.

argument: String

포스트백을 처리하는 컨트롤에 전달할 선택적 인수의 문자열입니다.

반환

String

클라이언트에서 스크립트로 처리될 때 포스트백을 시작하는 문자열입니다.

예외

ArgumentNullException

지정된 Control 값은 .입니다 null.

예제

다음 코드 예제에서는 메서드의 사용을 보여 줍니다 GetPostBackEventReference . 사용자 지정 컨트롤은 MyControl인터페이스를 IPostBackEventHandler 구현합니다. 페이지의 단추를 클릭하면 RaisePostBackEvent 사용자 지정 컨트롤의 메서드가 호출됩니다.

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

  public class MyControl : Label, IPostBackEventHandler
  {

    // Use the constructor to defined default label text.
    public MyControl()
    {
      base.Text = "No postback raised.";
    }
    
    // Implement the RaisePostBackEvent method from the
    // IPostBackEventHandler interface. 
    public void RaisePostBackEvent(string eventArgument)
    {
      base.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + ".";
      
    }
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Create an instance of the custom label control and 
    // add it to the page.
    MyControl mycontrol = new MyControl();
    mycontrol.ID = "mycontrol1";
    PlaceHolder1.Controls.Add(mycontrol);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(mycontrol, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(mycontrol, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </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">
  
  Public Class MyControl
    Inherits Label
    Implements IPostBackEventHandler
     
    Public Sub New()
      
      MyBase.Text = "No postback raised."
    
    End Sub
    
    Public Sub RaisePostBackEvent(ByVal eventArgument As String) Implements System.Web.UI.IPostBackEventHandler.RaisePostBackEvent
      
      MyBase.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
                "Postback caused by " + eventArgument.ToString() & "."

    End Sub
    
  End Class
   

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript

    ' Create an instance of the custom label control and 
    ' add it to the page.
    Dim mycontrol As New MyControl()
    MyControl.ID = "mycontrol1"
    PlaceHolder1.Controls.Add(MyControl)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(MyControl, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(MyControl, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

다음 코드 예제에서는 사용자 지정 컨트롤 Page 대신 클래스가 인터페이스를 구현한다는 점을 제외하고 이전 코드 예제와 동일한 기능을 제공합니다 IPostBackEventHandler .

<%@ Page Language="C#"  %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

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

<script runat="server">
  
  public void RaisePostBackEvent(string eventArgument)
  {
    Label1.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + "."; ;
  }
  
  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(this, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(this, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

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

<script runat="server">
 
  Public Sub RaisePostBackEvent(ByVal eventArgument As String) _
    Implements IPostBackEventHandler.RaisePostBackEvent
    
    Label1.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
           "Postback caused by " + eventArgument.ToString() & "."
  
  End Sub
  

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(Me, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(Me, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

설명

에 IPostBackEventHandler 대한 인터페이스를 Page구현하려면 지시문을 사용합니다 @ Implements .

추가 정보

적용 대상

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

ClientScriptManager.GetPostBackEventReference 메서드

정의

오버로드

GetPostBackEventReference(Control, String, Boolean)

매개 변수

반환

예외

설명

추가 정보

적용 대상

GetPostBackEventReference(PostBackOptions, Boolean)

매개 변수

반환

예외

설명

추가 정보

적용 대상

GetPostBackEventReference(PostBackOptions)

매개 변수

반환

예외

설명

추가 정보

적용 대상

GetPostBackEventReference(Control, String)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

피드백