FormViewInsertedEventArgs クラス
アセンブリ: System.Web (system.web.dll 内)


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"> </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"> </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"> </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"> </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.EventArgs
System.Web.UI.WebControls.FormViewInsertedEventArgs


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


FormViewInsertedEventArgs コンストラクタ
アセンブリ: System.Web (system.web.dll 内)

Dim affectedRows As Integer Dim e As Exception Dim instance As New FormViewInsertedEventArgs(affectedRows, e)

このコンストラクタを使用して、FormViewInsertedEventArgs クラスの新しいインスタンスを初期化します。
FormViewInsertedEventArgs のインスタンスの初期プロパティ値を次の表に示します。
AffectedRows | affectedRows パラメータの値。 |
ExceptionHandled | |
KeepInInsertMode |
![]() |
---|

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


FormViewInsertedEventArgs プロパティ

名前 | 説明 | |
---|---|---|
![]() | AffectedRows | 挿入操作の影響を受けた行の数を取得します。 |
![]() | Exception | 挿入操作中に例外が発生した場合は、その例外を取得します。 |
![]() | ExceptionHandled | 挿入操作中に発生した例外がイベント ハンドラで処理されたかどうかを示す値を取得または設定します。 |
![]() | KeepInInsertMode | 挿入操作後に FormView コントロールを挿入モードのまま維持するかどうかを示す値を取得または設定します。 |
![]() | Values | 挿入されたレコードのフィールドの名前と値のペアを格納しているディクショナリを取得します。 |

FormViewInsertedEventArgs メソッド

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

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


名前 | 説明 | |
---|---|---|
![]() | AffectedRows | 挿入操作の影響を受けた行の数を取得します。 |
![]() | Exception | 挿入操作中に例外が発生した場合は、その例外を取得します。 |
![]() | ExceptionHandled | 挿入操作中に発生した例外がイベント ハンドラで処理されたかどうかを示す値を取得または設定します。 |
![]() | KeepInInsertMode | 挿入操作後に FormView コントロールを挿入モードのまま維持するかどうかを示す値を取得または設定します。 |
![]() | Values | 挿入されたレコードのフィールドの名前と値のペアを格納しているディクショナリを取得します。 |

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

- FormViewInsertedEventArgsのページへのリンク