FormViewDeleteEventArgsとは? わかりやすく解説

FormViewDeleteEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ItemDeleting イベントのデータを提供します。

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

Public Class FormViewDeleteEventArgs
    Inherits CancelEventArgs
Dim instance As FormViewDeleteEventArgs
public class FormViewDeleteEventArgs : CancelEventArgs
public ref class FormViewDeleteEventArgs :
 public CancelEventArgs
public class FormViewDeleteEventArgs extends
 CancelEventArgs
public class FormViewDeleteEventArgs extends
 CancelEventArgs
解説解説

FormView コントロールは、コントロール内の Delete ボタン (CommandName プロパティが "Delete" に設定されたボタン) がクリックされた場合に、FormView コントロールが実際にレコードを削除する前に ItemDeleting イベントを発生させます。これにより、このイベントが発生するたびにカスタム ルーチン (削除前にレコードを検査するなど) を実行するイベント処理メソッドを提供できます。

FormViewDeleteEventArgs オブジェクトがイベント処理メソッドに渡されることにより、削除されるレコードのインデックスを確認したり、削除操作をキャンセルする必要があることを示したりできます。レコードのインデックスを確認するには、RowIndex プロパティを使用します。削除操作をキャンセルするには、Cancel プロパティを true に設定します。また、Keys プロパティを使用してキー フィールドにアクセスしたり、Values プロパティを使用してキー以外のフィールドにアクセスしたりすることもできます。これらの値は、削除前にレコードを検証する必要がある場合に役立ちます。

メモメモ

Keys プロパティでキー フィールド値を変更したり、Values プロパティでキー以外のフィールド値を変更したりすることもできます。これらの値を変更すると、新しい値に対応するレコードが削除されます。

イベント処理の詳細については、「イベントの利用」を参照してください。

FormViewDeleteEventArgs クラスのインスタンスの初期プロパティ値の一覧については、FormViewDeleteEventArgs コンストラクタのトピックを参照してください。

使用例使用例

ItemDeleting イベントのイベント処理メソッドに渡された FormViewDeleteEventArgs オブジェクトを使用して、削除操作をキャンセルする方法を次の例に示します。

<%@ Page language="VB" %>

<script runat="server">

  Sub EmployeeFormView_ItemDeleting(ByVal sender
 As Object, ByVal e As
 FormViewDeleteEventArgs)
  
    ' Get the employee ID, name, and job title from the Keys and Values
    ' properties.
    Dim keyValue As String
 = e.Keys("EmployeeID").ToString()
    Dim employeeName As String
 = e.Values("FirstName").ToString() & _
      " " & e.Values("LastName").ToString()
    Dim title As String
 = e.Values("Title").ToString()

    ' Cancel the delete operation if the user attempts to 
    ' delete a protected record. In this example, records for
    ' employees with a "Sales Manager" job title are protected.
    If Title.Equals("Sales Manager")
 Then
    
      e.Cancel = True
      MessageLabel.Text = "You cannot delete record "
 & _
        e.RowIndex.ToString() & ". " & employeeName
 & _
        " (Employee Number " & keyValue.ToString()
 & _
        ") is protected."
    
    End If

  End Sub
   
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>FormViewDeleteEventArgs Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        onitemdeleting="EmployeeFormView_ItemDeleting"
  
        runat="server">
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>'
 
                  runat="server"/>
              </td>
              <td>
                <asp:label id="FirstNameLabel"
                  text='<%#Bind("FirstName")%>'
                  font-bold="true"
                  runat="server"/>
                <asp:label id="LastNameLabel"
                  text='<%#Bind("LastName")%>'
                  font-bold="true"
                  runat="server"/>
                <br/>     
                <asp:label id="TitleLabel"
                  text='<%#Bind("Title")%>'
                  runat="server"/>        
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:button id="DeleteButton"
                  text="Delete Record"
                  commandname="Delete"
                  runat="server" />
              </td>
            </tr>
          </table>
        
        </itemtemplate>         
                  
      </asp:formview>
      
      <asp:label id="MessageLabel"
        forecolor="Red"
        runat="server"/>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName],
 [Title], [PhotoPath] From [Employees]"
        deletecommand="Delete [Employees] Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

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

<script runat="server">

  void EmployeeFormView_ItemDeleting(Object sender, FormViewDeleteEventArgs
 e)
  {
    // Get the employee ID, name, and job title from the Keys and Values
    // properties.
    String keyValue = e.Keys["EmployeeID"].ToString();
    String employeeName = e.Values["FirstName"].ToString() +
      " " + e.Values["LastName"].ToString();
    String title = e.Values["Title"].ToString();

    // Cancel the delete operation if the user attempts to 
    // delete a protected record. In this example, records for
    // employees with a "Sales Manager" job title are protected.
    if (title.Equals("Sales Manager"))
    {
      e.Cancel = true;
      MessageLabel.Text = "You cannot delete record " +
        e.RowIndex.ToString() + ". " + employeeName +
        " (Employee Number " + keyValue.ToString() +
        ") is protected.";
    }

  }
   
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>FormViewDeleteEventArgs Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        onitemdeleting="EmployeeFormView_ItemDeleting"  
        runat="server">
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <asp:label id="FirstNameLabel"
                  text='<%#Bind("FirstName")%>'
                  font-bold="true"
                  runat="server"/>
                <asp:label id="LastNameLabel"
                  text='<%#Bind("LastName")%>'
                  font-bold="true"
                  runat="server"/>
                <br/>     
                <asp:label id="TitleLabel"
                  text='<%#Bind("Title")%>'
                  runat="server"/>        
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:button id="DeleteButton"
                  text="Delete Record"
                  commandname="Delete"
                  runat="server" />
              </td>
            </tr>
          </table>
        
        </itemtemplate>         
                  
      </asp:formview>
      
      <asp:label id="MessageLabel"
        forecolor="Red"
        runat="server"/>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title],
 [PhotoPath] From [Employees]"
        deletecommand="Delete [Employees] Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

.NET Framework のセキュリティ.NET Framework のセキュリティ
継承階層継承階層
System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.FormViewDeleteEventArgs
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
FormViewDeleteEventArgs メンバ
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewDeleteEventHandler
CancelEventArgs
FormView.ItemDeleting イベント
Cancel
Keys
RowIndex
Values

FormViewDeleteEventArgs コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FormViewDeleteEventArgs クラスの新しいインスタンスを初期化します。

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

Public Sub New ( _
    rowIndex As Integer _
)
Dim rowIndex As Integer

Dim instance As New FormViewDeleteEventArgs(rowIndex)
public FormViewDeleteEventArgs (
    int rowIndex
)
public:
FormViewDeleteEventArgs (
    int rowIndex
)
public FormViewDeleteEventArgs (
    int rowIndex
)
public function FormViewDeleteEventArgs (
    rowIndex : int
)

パラメータ

rowIndex

削除される行インデックス。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
FormViewDeleteEventArgs クラス
FormViewDeleteEventArgs メンバ
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewDeletedEventHandler デリゲート
FormView.ItemDeleting イベント
RowIndex

FormViewDeleteEventArgs プロパティ


パブリック プロパティパブリック プロパティ

参照参照

関連項目

FormViewDeleteEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewDeleteEventHandler
CancelEventArgs
FormView.ItemDeleting イベント
Cancel
Keys
RowIndex
Values

FormViewDeleteEventArgs メソッド


FormViewDeleteEventArgs メンバ

ItemDeleting イベントのデータを提供します。

FormViewDeleteEventArgs データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド FormViewDeleteEventArgs FormViewDeleteEventArgs クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

FormViewDeleteEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewDeleteEventHandler
CancelEventArgs
FormView.ItemDeleting イベント
Cancel
Keys
RowIndex
Values



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「FormViewDeleteEventArgs」の関連用語

FormViewDeleteEventArgsのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



FormViewDeleteEventArgsのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS