GridViewUpdateEventArgs GridViewUpdateEventArgs GridViewUpdateEventArgs GridViewUpdateEventArgs Class

정의

RowUpdating 이벤트에 대한 데이터를 제공합니다.Provides data for the RowUpdating event.

public ref class GridViewUpdateEventArgs : System::ComponentModel::CancelEventArgs
public class GridViewUpdateEventArgs : System.ComponentModel.CancelEventArgs
type GridViewUpdateEventArgs = class
    inherit CancelEventArgs
Public Class GridViewUpdateEventArgs
Inherits CancelEventArgs
상속
GridViewUpdateEventArgsGridViewUpdateEventArgsGridViewUpdateEventArgsGridViewUpdateEventArgs

예제

다음 예제에서는 사용 하는 방법에 설명 합니다 GridViewUpdateEventArgs 개체 데이터 소스를 업데이트 하기 전에 사용자가 제공한 모든 값을 HTML 인코딩하려면 이벤트 처리 메서드에 전달 합니다.The following example demonstrates how to use the GridViewUpdateEventArgs object passed to the event-handling method to HTML-encode all values supplied by the user before updating the data source.


<%@ 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 CustomersGridView_RowUpdating(Object sender, GridViewUpdateEventArgs e)
  {
     
    // Iterate through the NewValues collection and HTML encode all 
    // user-provided values before updating the data source.
    foreach (DictionaryEntry entry in e.NewValues)
    {
    
      e.NewValues[entry.Key] = Server.HtmlEncode(entry.Value.ToString());
    
    }
        
  }
       
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView RowUpdating Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView RowUpdating Example</h3>
            
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"
        onrowupdating="CustomersGridView_RowUpdating"  
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </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 CustomersGridView_RowUpdating(ByVal sender As Object, ByVal e As GridViewUpdateEventArgs)
    
    ' Use the CopyTo method to copy the DictionaryEntry objects in the 
    ' NewValues collection to an array.
    Dim records(e.NewValues.Count - 1) As DictionaryEntry
    e.NewValues.CopyTo(records, 0)
    
    ' Iterate through the array and HTML encode all user-provided values 
    ' before updating the data source.
    Dim entry As DictionaryEntry
    For Each entry In records
            
      e.NewValues(entry.Key) = Server.HtmlEncode(entry.Value.ToString())
      
    Next
        
  End Sub
       
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView RowUpdating Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView RowUpdating Example</h3>
            
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"
        onrowupdating="CustomersGridView_RowUpdating"  
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

설명

합니다 GridView 를 발생 시킵니다 합니다 RowUpdating 행의 업데이트 단추를 클릭할 때 이벤트를 하기 전에 GridView 컨트롤이 행을 업데이트 합니다.The GridView control raises the RowUpdating event when a row's Update button is clicked, but before the GridView control updates the row. 이 옵션을 사용 하면이 이벤트가 발생할 때마다 업데이트 작업을 취소 하는 등 사용자 지정 루틴을 수행 하는 이벤트 처리 메서드를 제공할 수 있습니다.This allows you to provide an event-handling method that performs a custom routine, such as canceling the update operation, whenever this event occurs.

GridViewUpdateEventArgs 개체는 현재 행의 인덱스를 확인 하 고 업데이트 작업을 취소 해야 함을 나타낼 수는 이벤트 처리 메서드에 전달 됩니다.A GridViewUpdateEventArgs object is passed to the event-handling method, which allows you to determine the index of the current row and to indicate that the update operation should be canceled. 업데이트 작업을 취소 하려면 합니다 Cancel 의 속성을 GridViewUpdateEventArgs 개체를 true입니다.To cancel the update operation, set the Cancel property of the GridViewUpdateEventArgs object to true. 조작할 수도 있습니다는 Keys, OldValues, 및 NewValues 컬렉션 값이 데이터 원본에 전달 되기 전에 필요한 경우.You can also manipulate the Keys, OldValues, and NewValues collections, if necessary, before the values are passed to the data source. 이러한 컬렉션을 사용 하는 일반적인 방법은 데이터 원본에 저장 되기 전에 사용자가 제공한 값을 HTML로 인코딩하는 합니다.A common way to use these collections is to HTML-encode the values supplied by the user before they are stored in the data source. 이렇게 하면 스크립트 삽입 공격을 방지 합니다.This helps to prevent script injection attacks.

이벤트를 처리 하는 방법에 대 한 자세한 내용은 참조 하세요. 이벤트 처리 및 발생합니다.For more information about how to handle events, see Handling and Raising Events.

인스턴스의 초기 속성 값의 목록을 GridViewUpdateEventArgs, 참조는 GridViewSelectEventArgs 생성자입니다.For a list of initial property values for an instance of GridViewUpdateEventArgs, see the GridViewSelectEventArgs constructor.

생성자

GridViewUpdateEventArgs(Int32) GridViewUpdateEventArgs(Int32) GridViewUpdateEventArgs(Int32) GridViewUpdateEventArgs(Int32)

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

속성

Cancel Cancel Cancel Cancel

이벤트를 취소해야 할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Keys Keys Keys Keys

업데이트할 행의 기본 키를 나타내는 필드 이름/값 쌍의 사전을 가져옵니다.Gets a dictionary of field name/value pairs that represent the primary key of the row to update.

NewValues NewValues NewValues NewValues

업데이트할 행에 있는 키가 아닌 필드 이름/값 쌍의 수정된 값이 들어 있는 사전을 가져옵니다.Gets a dictionary containing the revised values of the non-key field name/value pairs in the row to update.

OldValues OldValues OldValues OldValues

업데이트할 행에 있는 필드의 원래 이름/값 쌍이 들어 있는 사전을 가져옵니다.Gets a dictionary containing the original field name/value pairs in the row to update.

RowIndex RowIndex RowIndex RowIndex

업데이트하고 있는 행의 인덱스를 가져옵니다.Gets the index of the row being updated.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

적용 대상

추가 정보