PostBackOptions 클래스

참조

정의

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

어셈블리:: System.Web.dll

중요

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

클라이언트측 JavaScript를 생성하여 포스트백 이벤트를 시작하는 방법을 지정합니다.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

상속: Object
PostBackOptions

예제

다음 코드 예제에서는 OnClick 의 이벤트를 Button 컨트롤에 대 한 클라이언트 쪽 스크립트를 생성 하는 HyperLink 수 있는 컨트롤은 HyperLink 포스트백 이벤트를 컨트롤 합니다. 때문에 합니다 ActionUrl 의 속성을 myPostBackOptions 개체 "Page2.aspx"으로 설정 되 면 포스트백을 제공 하지는 "Page2.aspx" 라는 다른 페이지로 Web Forms 페이지에 게시 됩니다. 이 예제를 사용 하려면 프로젝트 또는 디렉터리 "Page2.aspx" 이라는 다른 웹 페이지를 추가 해야 합니다.

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class postbackoptionscs : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (Page.IsPostBack)
        {
            Label1.Text = "A postback event has occurred.";
        }
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        // Create a new PostBackOptions object and set its properties.
        PostBackOptions myPostBackOptions = new PostBackOptions(this);
        myPostBackOptions.ActionUrl = "Page2.aspx";
        myPostBackOptions.AutoPostBack = false;
        myPostBackOptions.RequiresJavaScriptProtocol = true;
        myPostBackOptions.PerformValidation = true;

        // Add the client-side script to the HyperLink1 control.
        HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions);

        Label1.Text = "Click this hyperlink to initiate a postback event.";
    }
}

Partial Class postbackoptionsvb
    Inherits System.Web.UI.Page
    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

        ' Create a new PostBackOptions object and set its properties.
        Dim myPostBackOptions As PostBackOptions = New PostBackOptions(Me)
        myPostBackOptions.ActionUrl = "Page2.aspx"
        myPostBackOptions.AutoPostBack = False
        myPostBackOptions.RequiresJavaScriptProtocol = True
        myPostBackOptions.PerformValidation = True

        ' Add the client-side script to the HyperLink1 control.
        HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions)

        Label1.Text = "Click this hyperlink to initiate a postback event."

    End Sub

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

        If Page.IsPostBack Then
            Label1.Text = "A postback event has occurred."
        End If

    End Sub
End Class

다음 코드 예제는 이전 코드 숨김 파일을 실행 하려면 사용할 수 있는 웹 페이지입니다.

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="postbackoptions.aspx.cs" Inherits="postbackoptionscs" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>PostBackOptions Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <h3>PostBackOptions Example Page</h3>
      Click this button to create client-side script for the 
      Postback hyperlink that causes a postback event to occur.
      <br />
      <asp:Button id="Button1" 
        runat="server" 
        text="Create Script" 
        onclick="Button1_Click" />
      <br /><br />
      <asp:Label id="Label1" 
        runat="server" 
        text="">
      </asp:Label>
      <br />
      <asp:HyperLink id="HyperLink1" 
        runat="server" 
        text="Postback">
      </asp:HyperLink>
    </form>
  </body>
</html>

<%@ Page Language="VB" AutoEventWireup="true" CodeFile="postbackoptions.aspx.vb" Inherits="postbackoptionsvb" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>PostBackOptions Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <h3>PostBackOptions Example Page</h3>
      Click this button to create client-side script for the 
      Postback hyperlink that causes a postback event to occur.
      <br />
      <asp:Button id="Button1" 
        runat="server" 
        text="Create Script" 
        onclick="Button1_Click" />
      <br /><br />
      <asp:Label id="Label1" 
        runat="server" 
        text=""></asp:Label>
      <br />
      <asp:HyperLink id="HyperLink1" 
        runat="server" 
        text="Postback"></asp:HyperLink>
      <br />
    </form>
  </body>
</html>

설명

PostBackOptions 클래스 컨트롤을 포스트백 이벤트를 시작 하는 클라이언트 쪽 스크립트를 내보낼 수 있습니다. 합니다 PostBackOptions 클래스를 통해 포스트백 이벤트를 시작 하는 컨트롤에 대 한 참조를 제공 합니다 TargetControl 속성입니다. 포스트백 이벤트에 지정 된 옵션에 따라 만들어집니다 합니다 PostBackOptions 에 전달 된 개체는 ClientScriptManager.GetPostBackEventReference 메서드.

일반적으로 서버에 포스트백의 제출 단추 또는 이미지 단추와 같은 요소에 의해 시작 됩니다. 그러나 내보내기 클라이언트 쪽 JavaScript에서 다양 한 컨트롤이 포스트백 이벤트를 시작할 수 있습니다.

생성자

PostBackOptions(Control)	지정된 대상 컨트롤 데이터를 사용하여 PostBackOptions 클래스의 새 인스턴스를 초기화합니다.
PostBackOptions(Control, String)	지정된 대상 컨트롤 및 인수 데이터를 사용하여 PostBackOptions 클래스의 새 인스턴스를 초기화합니다.
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	지정된 인스턴스 속성 값을 사용하여 PostBackOptions 클래스의 새 인스턴스를 초기화합니다.

속성

ActionUrl	Web Forms 페이지의 포스트백을 위한 대상 URL을 가져오거나 설정합니다.
Argument	포스트백 이벤트에서 전달되는 선택적 인수를 가져오거나 설정합니다.
AutoPostBack	사용자 동작에 대한 응답으로 폼이 서버에 자동으로 포스트백될지 여부를 나타내는 값을 가져오거나 설정합니다.
ClientSubmit	클라이언트측 스크립트로부터 포스트백 이벤트가 발생할지 여부를 나타내는 값을 가져오거나 설정합니다.
PerformValidation	포스트백 이벤트가 발생하기 전에 클라이언트측 유효성 검사를 수행할지 여부를 나타내는 값을 가져오거나 설정합니다.
RequiresJavaScriptProtocol	클라이언트측 스크립트에 대해 `javascript:` 접두사가 생성되는지 여부를 나타내는 값을 가져오거나 설정합니다.
TargetControl	포스트백 이벤트를 받는 컨트롤 대상을 가져옵니다.
TrackFocus	포스트백 이벤트가 페이지를 현재 스크롤 위치에 반환하고 포커스를 대상 컨트롤에 반환할지 여부를 나타내는 값을 가져오거나 설정합니다.
ValidationGroup	서버에 포스트백될 때 PostBackOptions 개체가 유효성 검사를 수행할 컨트롤 그룹을 가져오거나 설정합니다.

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

적용 대상

추가 정보

GetPostBackEventReference(PostBackOptions)

PostBackOptions 클래스

정의

예제

설명

생성자

속성

메서드

적용 대상

추가 정보

추가 리소스