GridViewDeletedEventArgs.AffectedRows プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

GridViewDeletedEventArgs.AffectedRows プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

削除操作の影響を受けた行の数を取得します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 AffectedRows As Integer

Visual Basic (使用法)

Dim instance As GridViewDeletedEventArgs
Dim value As Integer

value = instance.AffectedRows

public int AffectedRows { get;
 }

C++

public:
property int AffectedRows {
    int get ();
}

/** @property */
public int get_AffectedRows ()

JScript

public function get AffectedRows
 () : int

プロパティ値
削除操作の影響を受けた行の数。

解説

AffectedRows プロパティを使用して、削除操作の影響を受けた行の数を確認します。通常、このプロパティは、以下のような場合に正しい数のレコードが削除されたことを確認するために使用されます。

1 レコードだけが削除されたことを確認する。作成した delete ステートメントが正しくない場合に、複数のレコードが削除されることがあります。
例外を発生させない削除操作でエラーが発生した場合に、レコードが削除されたことを確認する。
オプティミスティック同時実行制御をサポートするデータソースコントロール (SqlDataSource コントロールや ObjectDataSource コントロールなど) の ConflictDetection プロパティが ConflictOptions.CompareAllValues 列挙値に設定されている場合に、レコードが削除されたことを確認する。この設定では、同時に別のユーザーによって変更されたレコードは削除されません。

使用例

AffectedRows プロパティを使用して、削除操作中にレコードが削除されたことを確認する方法を次の例に示します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub CustomersGridView_RowDeleted(ByVal sender
 As Object, ByVal e As
 GridViewDeletedEventArgs)

    ' Use the Exception property to determine whether an exception
    ' occurred during the delete operation.
    If e.Exception Is Nothing
 Then

      ' Use the AffectedRows property to determine whether the
      ' record was deleted. Sometimes an error might occur that 
      ' does not raise an exception, but prevents the delete
      ' operation from completing.
      If e.AffectedRows = 1 Then
      
        Message.Text = "Record deleted successfully."
      
      Else
      
        Message.Text = "An error occurred during the delete operation."
      
      End If
    
    Else
          
      ' Insert the code to handle the exception.
      Message.Text = "An error occurred during the delete operation."

      ' Use the ExceptionHandled property to indicate that the 
      ' exception is already handled.
      e.ExceptionHandled = True
    
    End If
    
  End Sub
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewDeletedEventArgs Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"          
        runat="server"/>
                
      <br/>
            
      <!-- 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"
        autogeneratedeletebutton="true"
        datakeynames="CustomerID"
        onrowdeleted="CustomersGridView_RowDeleted"
  
        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]"
        deletecommand="Delete from Customers where CustomerID
 = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
      
    </form>
  </body>
</html>

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

<script runat="server">

  void CustomersGridView_RowDeleted(Object sender, GridViewDeletedEventArgs
 e)
  {

    // Use the Exception property to determine whether an exception
    // occurred during the delete operation.
    if (e.Exception == null)
    {
      // Use the AffectedRows property to determine whether the
      // record was deleted. Sometimes an error might occur that 
      // does not raise an exception, but prevents the delete
      // operation from completing.
      if (e.AffectedRows == 1)
      {
        Message.Text = "Record deleted successfully.";
      }
      else
      {
        Message.Text = "An error occurred during the delete operation.";
      }
    }
    else
    {
      // Insert the code to handle the exception.
      Message.Text = "An error occurred during the delete operation.";

      // Use the ExceptionHandled property to indicate that the 
      // exception is already handled.
      e.ExceptionHandled = true;
    }
    
  }
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewDeletedEventArgs Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"          
        runat="server"/>
                
      <br/>
            
      <!-- 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"
        autogeneratedeletebutton="true"
        datakeynames="CustomerID"
        onrowdeleted="CustomersGridView_RowDeleted"  
        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]"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
      
    </form>
  </body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
GridViewDeletedEventArgs クラス
GridViewDeletedEventArgs メンバ
System.Web.UI.WebControls 名前空間
GridView クラス
GridViewDeletedEventHandler
GridView.RowDeleted イベント
Exception
ExceptionHandled
ConflictDetection
ConflictOptions

このページでは「.NET Framework クラスライブラリリファレンス」からGridViewDeletedEventArgs.AffectedRows プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からGridViewDeletedEventArgs.AffectedRows プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からGridViewDeletedEventArgs.AffectedRows プロパティを検索

>> 「GridViewDeletedEventArgs.AffectedRows プロパティ」を含む用語の索引
GridViewDeletedEventArgs.AffectedRows プロパティのページへのリンク

GridViewDeletedEventArgs.AffectedRows プロパティとは？わかりやすく解説

GridViewDeletedEventArgs.AffectedRows プロパティ

「GridViewDeletedEventArgs.AffectedRows プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

GridViewDeletedEventArgs.AffectedRows プロパティとは？ わかりやすく解説

GridViewDeletedEventArgs.AffectedRows プロパティ

急上昇のことば

「GridViewDeletedEventArgs.AffectedRows プロパティ」の関連用語

GridViewDeletedEventArgs.AffectedRows プロパティとは？わかりやすく解説