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

FormViewUpdatedEventArgs クラス

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

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

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

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

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

FormViewUpdatedEventArgs オブジェクトイベント処理メソッド渡されることにより、影響受けたレコード数および発生した例外確認できます更新操作影響受けたレコード数を確認するには、AffectedRows プロパティ使用します例外発生しているかどうか確認するには、Exception プロパティ使用します。ExceptionHandled プロパティ設定することにより、イベント処理メソッドで既に例外処理されたかどうかを示すこともできます更新されレコードの元のキー フィールド値にアクセスする必要がある場合は、Keys プロパティ使用します。元のキー以外のフィールド値には、OldValues プロパティ使用してアクセスできます更新された値 (ユーザーキー フィールド編集できるようにしている場合更新されキー フィールド値も含む) には、NewValues プロパティ使用してアクセスできます

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

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

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

使用例使用例

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

<%@ Page language="VB" %>

<script runat="server">

  Sub EmployeeFormView_ItemUpdated(ByVal sender
 As Object, ByVal e As
 FormViewUpdatedEventArgs) Handles EmployeeFormView.ItemUpdated

    ' Use the Exception property to determine whether an exception
    ' occurred during the update operation.
    If e.Exception Is Nothing
 Then
    
      ' Sometimes an error might occur that does not raise an 
      ' exception, but prevents the update operation from 
      ' completing. Use the AffectedRows property to determine 
      ' whether the record was actually updated. 
      If e.AffectedRows = 1 Then
      
        ' Use the Keys property to get the value of the key field.
        Dim keyFieldValue As String
 = e.Keys("EmployeeID").ToString()

        ' Display a confirmation message.
        MessageLabel.Text = "Record " & keyFieldValue
 & _
          " updated successfully. "

        ' Display the new and original values.
        DisplayValues(CType(e.NewValues, OrderedDictionary), CType(e.OldValues, OrderedDictionary))
      
      Else
      
        ' Display an error message.
        MessageLabel.Text = "An error occurred during the update
 operation."

        ' When an error occurs, keep the FormView
        ' control in edit mode.
        e.KeepInEditMode = 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.KeepInEditMode = True
    
    End If
    
  End Sub

  Sub DisplayValues(ByVal newValues As
 OrderedDictionary, ByVal oldValues As OrderedDictionary)

    MessageLabel.Text &= "<br/></br>"

    ' Iterate through the new and old values. Display the
    ' values on the page.
    Dim i As Integer
    For i = 0 To oldValues.Count - 1
    
      MessageLabel.Text &= "Old Value=" &
 oldValues(i).ToString() & _
        ", New Value=" & newValues(i).ToString()
 & "<br/>"
    Next

    MessageLabel.Text &= "</br>"

  End Sub

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>FormViewUpdatedEventArgs Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."
        runat="server">
        
        <itemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>'
 
                  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>
                <b>Hire Date:</b>                
 
              </td>
              <td>
                <%# Eval("HireDate","{0:d}")
 %>
              </td>
            </tr>
            <tr height="150" valign="top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <%# Eval("Address") %><br/>
                <%# Eval("City") %> <%# Eval("Region")
 %>
                <%# Eval("PostalCode") %><br/>
                <%# Eval("Country") %>   
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="Edit"
                  text="Edit"
                  commandname="Edit"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <edititemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeEditImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>'
 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameUpdateTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameUpdateTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleUpdateTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td>
                <b>Hire Date:</b>                
 
              </td>
              <td>
                <asp:textbox id="HireDateUpdateTextBox"
                  text='<%# Bind("HireDate", "{0:d}")
 %>'
                  runat="server"/>
              </td>
            </tr>
            <tr height="150" valign="top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <asp:textbox id="AddressUpdateTextBox"
                  text='<%# Bind("Address") %>'
                  runat="server"/>
                <br/>
                <asp:textbox id="CityUpdateTextBox"
                  text='<%# Bind("City") %>'
                  runat="server"/> 
                <asp:textbox id="RegionUpdateTextBox"
                  text='<%# Bind("Region") %>'
                  width="40"
                  runat="server"/>
                <asp:textbox id="PostalCodeUpdateTextBox"
                  text='<%# Bind("PostalCode") %>'
                  width="60"
                  runat="server"/>
                <br/>
                <asp:textbox id="CountryUpdateTextBox"
                  text='<%# Bind("Country") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="UpdateButton"
                  text="Update"
                  commandname="Update"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </edititemtemplate>
                  
      </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], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath]
 From [Employees]"
        updatecommand="Update [Employees] Set [LastName]=@LastName,
 [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region,
 [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

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

<script runat="server">

  void EmployeeFormView_ItemUpdated(Object sender, FormViewUpdatedEventArgs
 e)
  {
    // Use the Exception property to determine whether an exception
    // occurred during the update operation.
    if (e.Exception == null)
    {
      // Sometimes an error might occur that does not raise an 
      // exception, but prevents the update operation from 
      // completing. Use the AffectedRows property to determine 
      // whether the record was actually updated. 
      if (e.AffectedRows == 1)
      {
        // Use the Keys property to get the value of the key field.
        String keyFieldValue = e.Keys["EmployeeID"].ToString();

        // Display a confirmation message.
        MessageLabel.Text = "Record " + keyFieldValue +
          " updated successfully. ";

        // Display the new and original values.
        DisplayValues((OrderedDictionary)e.NewValues, (OrderedDictionary)e.OldValues);
      }
      else
      {
        // Display an error message.
        MessageLabel.Text = "An error occurred during the update operation.";

        // When an error occurs, keep the FormView
        // control in edit mode.
        e.KeepInEditMode = 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.KeepInEditMode = true;
    }
  }

  void DisplayValues(OrderedDictionary newValues, OrderedDictionary
 oldValues)
  {

    MessageLabel.Text += "<br/></br>";

    // Iterate through the new and old values. Display the
    // values on the page.
    for (int i = 0; i < oldValues.Count;
 i++)
    {
      MessageLabel.Text += "Old Value=" + oldValues[i].ToString() +
        ", New Value=" + newValues[i].ToString() + "<br/>";
    }

    MessageLabel.Text += "</br>";

  }

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>FormViewUpdatedEventArgs Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."
        onitemupdated="EmployeeFormView_ItemUpdated"   
        runat="server">
        
        <itemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  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>
                <b>Hire Date:</b>                 
              </td>
              <td>
                <%# Eval("HireDate","{0:d}") %>
              </td>
            </tr>
            <tr height="150" valign="top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <%# Eval("Address") %><br/>
                <%# Eval("City") %> <%# Eval("Region")
 %>
                <%# Eval("PostalCode") %><br/>
                <%# Eval("Country") %>   
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="Edit"
                  text="Edit"
                  commandname="Edit"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <edititemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeEditImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameUpdateTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameUpdateTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleUpdateTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td>
                <b>Hire Date:</b>                 
              </td>
              <td>
                <asp:textbox id="HireDateUpdateTextBox"
                  text='<%# Bind("HireDate", "{0:d}") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr height="150" valign="top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <asp:textbox id="AddressUpdateTextBox"
                  text='<%# Bind("Address") %>'
                  runat="server"/>
                <br/>
                <asp:textbox id="CityUpdateTextBox"
                  text='<%# Bind("City") %>'
                  runat="server"/> 
                <asp:textbox id="RegionUpdateTextBox"
                  text='<%# Bind("Region") %>'
                  width="40"
                  runat="server"/>
                <asp:textbox id="PostalCodeUpdateTextBox"
                  text='<%# Bind("PostalCode") %>'
                  width="60"
                  runat="server"/>
                <br/>
                <asp:textbox id="CountryUpdateTextBox"
                  text='<%# Bind("Country") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="UpdateButton"
                  text="Update"
                  commandname="Update"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </edititemtemplate>
                  
      </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],
 [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From
 [Employees]"
        updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName,
 [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode,
 [Country]=@Country Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

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

FormViewUpdatedEventArgs コンストラクタ

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

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

名前空間: 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 FormViewUpdatedEventArgs(affectedRows,
 e)
public FormViewUpdatedEventArgs (
    int affectedRows,
    Exception e
)
public:
FormViewUpdatedEventArgs (
    int affectedRows, 
    Exception^ e
)
public FormViewUpdatedEventArgs (
    int affectedRows, 
    Exception e
)
public function FormViewUpdatedEventArgs (
    affectedRows : int, 
    e : Exception
)

パラメータ

affectedRows

更新操作影響受けた行の数。

e

更新操作実行時発生した例外を表す Exception例外発生しない場合は、このパラメータnull 参照 (Visual Basic では Nothing) を使用します

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

FormViewUpdatedEventArgs プロパティ


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

  名前 説明
パブリック プロパティ AffectedRows 更新操作影響受けた行の数を取得します
パブリック プロパティ Exception 更新操作中に例外発生した場合は、その例外取得します
パブリック プロパティ ExceptionHandled 更新操作中に発生した例外イベント ハンドラ処理されたかどうかを示す値を取得または設定します
パブリック プロパティ KeepInEditMode 更新操作後に FormView コントロール編集モードのまま維持するかどうかを示す値を取得または設定します
パブリック プロパティ Keys 更新されレコードの元のキー フィールドの名前と値のペアが格納されているディクショナリを取得します
パブリック プロパティ NewValues 更新されレコード新しフィールドの名前と値のペアが格納されているディクショナリを取得します
パブリック プロパティ OldValues 更新されレコードの元のキー以外のフィールドの名前と値のペアが格納されているディクショナリを取得します
参照参照

関連項目

FormViewUpdatedEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewUpdatedEventHandler
FormView.ItemUpdated イベント
AffectedRows
Exception
ExceptionHandled
KeepInEditMode

その他の技術情報

イベント利用

FormViewUpdatedEventArgs メソッド


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

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

関連項目

FormViewUpdatedEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewUpdatedEventHandler
FormView.ItemUpdated イベント
AffectedRows
Exception
ExceptionHandled
KeepInEditMode

その他の技術情報

イベント利用

FormViewUpdatedEventArgs メンバ

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

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド FormViewUpdatedEventArgs FormViewUpdatedEventArgs クラス新しインスタンス初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ AffectedRows 更新操作影響受けた行の数を取得します
パブリック プロパティ Exception 更新操作中に例外発生した場合は、その例外取得します
パブリック プロパティ ExceptionHandled 更新操作中に発生した例外イベント ハンドラ処理されたかどうかを示す値を取得または設定します
パブリック プロパティ KeepInEditMode 更新操作後に FormView コントロール編集モードのまま維持するかどうかを示す値を取得または設定します
パブリック プロパティ Keys 更新されレコードの元のキー フィールドの名前と値のペアが格納されているディクショナリを取得します
パブリック プロパティ NewValues 更新されレコード新しフィールドの名前と値のペアが格納されているディクショナリを取得します
パブリック プロパティ OldValues 更新されレコードの元のキー以外のフィールドの名前と値のペアが格納されているディクショナリを取得します
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

FormViewUpdatedEventArgs クラス
System.Web.UI.WebControls 名前空間
FormView クラス
FormViewUpdatedEventHandler
FormView.ItemUpdated イベント
AffectedRows
Exception
ExceptionHandled
KeepInEditMode

その他の技術情報

イベント利用


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

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

辞書ショートカット

すべての辞書の索引

「FormViewUpdatedEventArgs」の関連用語

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

   

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



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

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

©2025 GRAS Group, Inc.RSS