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

FormViewInsertedEventArgs クラス

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

ItemInserted イベントデータ提供します

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

Public Class FormViewInsertedEventArgs
    Inherits EventArgs
Dim instance As FormViewInsertedEventArgs
public class FormViewInsertedEventArgs : EventArgs
public ref class FormViewInsertedEventArgs
 : public EventArgs
public class FormViewInsertedEventArgs extends
 EventArgs
public class FormViewInsertedEventArgs extends
 EventArgs
解説解説

FormView コントロールは、コントロール内の Insert ボタン (CommandName プロパティが "Insert" に設定されボタン) がクリックされた場合に、FormView コントロール実際にレコード挿入した後に ItemInserted イベント発生させます。これにより、このイベント発生するたびにカスタム ルーチン (挿入操作結果確認するなど) を実行するイベント処理メソッドを提供できます

FormViewInsertedEventArgs オブジェクトイベント処理メソッド渡されることにより、影響受けたレコード数および発生した例外確認できます挿入操作影響受けたレコード数を確認するには、AffectedRows プロパティ使用します例外発生しているかどうか確認するには、Exception プロパティ使用します。ExceptionHandled プロパティ設定することにより、イベント処理メソッドで既に例外処理されたかどうかを示すこともできます挿入されレコードの値にアクセスする必要がある場合は、Values プロパティ使用します

既定では、FormView コントロールは、挿入操作の後、DefaultMode プロパティ指定されているモード戻ります。KeepInInsertMode プロパティtrue設定することにより、挿入操作中に例外発生した場合に、FormView コントロール挿入モードのまま維持できます

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

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

使用例使用例

ItemInserted イベントイベント処理メソッド渡されFormViewInsertedEventArgs オブジェクト使用して挿入操作中に例外発生したかどうか確認する方法次の例に示します

<%@ Page language="VB" %>

<script runat="server">

  Sub EmployeeFormView_ItemInserted(ByVal sender
 As Object, ByVal e As
 FormViewInsertedEventArgs)
  
    ' Use the Exception property to determine whether an exception
    ' occurred during the insert operation.
    If e.Exception Is Nothing
 Then
    
      ' Use the AffectedRows property to determine whether the
      ' record was inserted. Sometimes an error might occur that 
      ' does not raise an exception, but prevents the insert
      ' operation from completing.
      If e.AffectedRows = 1 Then
      
        MessageLabel.Text = "Record inserted successfully."
      
      Else
      
        MessageLabel.Text = "An error occurred during the insert
 operation."
        
        ' Use the KeepInInsertMode property to remain in insert mode
        ' when an error occurs during the insert operation.
        e.KeepInInsertMode = True
      
      End If
    
    Else
    
      ' Insert the code to handle the exception.
      MessageLabel.Text = e.Exception.Message
      
      ' Use the ExceptionHandled property to indicate that the 
      ' exception has already been handled.
      e.ExceptionHandled = True
      e.KeepInInsertMode = True
    
    End If
        
  End Sub

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>FormViewInsertedEventArgs Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."
        oniteminserted="EmployeeFormView_ItemInserted"
  
        runat="server">

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="5">
                <asp:image id="CompanyLogoImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company Logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%#
 Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="NewButton"
                  text="New"
                  commandname="New"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <insertitemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="CompanyLogoEditImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company Logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameInsertTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameInsertTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleInsertTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="InsertButton"
                  text="Insert"
                  commandname="Insert"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </insertitemtemplate> 
                  
      </asp:formview>
      
      <br/><br/>
      
      <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]"
        insertcommand="Insert Into [Employees] ([LastName], [FirstName],
 [Title]) VALUES (@LastName, @FirstName, @Title)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

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

<script runat="server">

  void EmployeeFormView_ItemInserted(Object sender, FormViewInsertedEventArgs
 e)
  {
    // Use the Exception property to determine whether an exception
    // occurred during the insert operation.
    if (e.Exception == null)
    {
      // Use the AffectedRows property to determine whether the
      // record was inserted. Sometimes an error might occur that 
      // does not raise an exception, but prevents the insert
      // operation from completing.
      if (e.AffectedRows == 1)
      {
        MessageLabel.Text = "Record inserted successfully.";
      }
      else
      {
        MessageLabel.Text = "An error occurred during the insert operation.";
        
        // Use the KeepInInsertMode property to remain in insert mode
        // when an error occurs during the insert operation.
        e.KeepInInsertMode = true;
      }
    }
    else
    {
      // Insert the code to handle the exception.
      MessageLabel.Text = e.Exception.Message;
      
      // Use the ExceptionHandled property to indicate that the 
      // exception has already been handled.
      e.ExceptionHandled = true;
      e.KeepInInsertMode = true;
    }
  }

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>FormViewInsertedEventArgs Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."
        oniteminserted="EmployeeFormView_ItemInserted"  
        runat="server">

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="5">
                <asp:image id="CompanyLogoImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company Logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName")
 %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="NewButton"
                  text="New"
                  commandname="New"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <insertitemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="CompanyLogoEditImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company Logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameInsertTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameInsertTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleInsertTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="InsertButton"
                  text="Insert"
                  commandname="Insert"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </insertitemtemplate> 
                  
      </asp:formview>
      
      <br/><br/>
      
      <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]"
        insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title])
 VALUES (@LastName, @FirstName, @Title)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

継承階層継承階層
System.Object
   System.EventArgs
    System.Web.UI.WebControls.FormViewInsertedEventArgs
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
FormViewInsertedEventArgs メンバ
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewInsertedEventHandler
FormView.ItemInserted イベント
AffectedRows
Exception
ExceptionHandled
KeepInInsertMode
Values
その他の技術情報
イベント利用

FormViewInsertedEventArgs コンストラクタ

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

FormViewInsertedEventArgs クラス新しインスタンス初期化します。

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

Public Sub New ( _
    affectedRows As Integer, _
    e As Exception _
)
Dim affectedRows As Integer
Dim e As Exception

Dim instance As New FormViewInsertedEventArgs(affectedRows,
 e)
public FormViewInsertedEventArgs (
    int affectedRows,
    Exception e
)
public:
FormViewInsertedEventArgs (
    int affectedRows, 
    Exception^ e
)
public FormViewInsertedEventArgs (
    int affectedRows, 
    Exception e
)
public function FormViewInsertedEventArgs (
    affectedRows : int, 
    e : Exception
)

パラメータ

affectedRows

挿入操作影響受けた行の数。

e

挿入操作実行されたときに発生した例外を表す Exception例外発生しなかった場合は、このパラメータnull 参照 (Visual Basic では Nothing) を使用します

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
FormViewInsertedEventArgs クラス
FormViewInsertedEventArgs メンバ
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewInsertedEventHandler
FormView.ItemInserted イベント
AffectedRows
Exception
ExceptionHandled
KeepInInsertMode

FormViewInsertedEventArgs プロパティ


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

参照参照

関連項目

FormViewInsertedEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewInsertedEventHandler
FormView.ItemInserted イベント
AffectedRows
Exception
ExceptionHandled
KeepInInsertMode
Values

その他の技術情報

イベント利用

FormViewInsertedEventArgs メソッド


パブリック メソッドパブリック メソッド

プロテクト メソッドプロテクト メソッド
参照参照

関連項目

FormViewInsertedEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewInsertedEventHandler
FormView.ItemInserted イベント
AffectedRows
Exception
ExceptionHandled
KeepInInsertMode
Values

その他の技術情報

イベント利用

FormViewInsertedEventArgs メンバ

ItemInserted イベントデータ提供します

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


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

関連項目

FormViewInsertedEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewInsertedEventHandler
FormView.ItemInserted イベント
AffectedRows
Exception
ExceptionHandled
KeepInInsertMode
Values

その他の技術情報

イベント利用



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「FormViewInsertedEventArgs」の関連用語

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

   

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



FormViewInsertedEventArgsのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

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

©2025 GRAS Group, Inc.RSS