DetailsViewInsertedEventArgs クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説DetailsView コントロールは、コントロール内の Insert ボタン (CommandName プロパティが "Insert" に設定されたボタン) がクリックされた場合に、DetailsView コントロールが実際にレコードを挿入した後に ItemInserted イベントを発生させます。これにより、このイベントが発生するたびにカスタム ルーチン (挿入操作の結果を確認するなど) を実行するイベント ハンドラを提供できます。
DetailsViewInsertedEventArgs オブジェクトがイベント ハンドラに渡され、これにより影響を受けたレコード数および発生した例外を確認できます。挿入操作の影響を受けたレコード数を確認するには、AffectedRows プロパティを使用します。例外が発生しているかどうかを確認するには、Exception プロパティを使用します。ExceptionHandled プロパティを設定することにより、イベント ハンドラで既に例外が処理されたかどうかを示すこともできます。挿入されたレコードの値にアクセスする必要がある場合は、Values プロパティを使用します。
既定では、DetailsView コントロールは、挿入操作の後、DefaultMode プロパティで指定されているモードに戻ります。DetailsView コントロールを挿入モードのまま維持するには、KeepInInsertMode プロパティを true に設定します。
イベント処理の詳細については、「イベントの利用」を参照してください。
DetailsViewDeletedEventArgs クラスのインスタンスの初期プロパティ値の一覧については、DetailsViewDeletedEventArgs コンストラクタのトピックを参照してください。
使用例ItemInserted イベントのイベント ハンドラに渡された DetailsViewInsertedEventArgs オブジェクトを使用して、挿入操作中に例外が発生したかどうかを確認する方法のコード例を次に示します。
<%@ Page language="VB" autoeventwireup="false" %> <script runat="server"> Sub CustomerDetailsView_ItemInserted(ByVal sender As Object, _ ByVal e As DetailsViewInsertedEventArgs) _ Handles CustomerDetailsView.ItemInserted ' Use the Exception property to determine whether an exception ' occurred during the insert operation. If e.Exception Is Nothing And e.AffectedRows = 1 Then ' Use the Values property to get the value entered by ' the user for the CompanyName field. Dim name As String = e.Values("CompanyName").ToString() ' Display a confirmation message. MessageLabel.Text = name & " added successfully. " Else ' Insert the code to handle the exception. MessageLabel.Text = e.Exception.Message ' Use the ExceptionHandled property to indicate that the ' exception is already handled. e.ExceptionHandled = True ' When an exception occurs, keep the DetailsView ' control in insert mode. e.KeepInInsertMode = True End If End Sub </script> <html> <body> <form runat="server"> <h3>DetailsViewInsertedEventArgs Example</h3> <asp:detailsview id="CustomerDetailsView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogenerateinsertbutton="true" autogeneraterows="true" allowpaging="true" runat="server"> <fieldheaderstyle backcolor="Navy" forecolor="White"/> </asp:detailsview> <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="DetailsViewSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" insertcommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)" connectionstring= "<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
<%@ Page language="C#" %> <script runat="server"> void CustomerDetailsView_ItemInserted(Object sender, DetailsViewInsertedEventArgs e) { // Use the Exception property to determine whether an exception // occurred during the insert operation. if (e.Exception == null && e.AffectedRows == 1) { // Use the Values property to get the value entered by // the user for the CompanyName field. String name = e.Values["CompanyName"].ToString(); // Display a confirmation message. MessageLabel.Text = name + " added successfully. "; } else { // Insert the code to handle the exception. MessageLabel.Text = e.Exception.Message; // Use the ExceptionHandled property to indicate that the // exception is already handled. e.ExceptionHandled = true; // When an exception occurs, keep the DetailsView // control in insert mode. e.KeepInInsertMode = true; } } </script> <html> <body> <form runat="server"> <h3>DetailsViewInsertedEventArgs Example</h3> <asp:detailsview id="CustomerDetailsView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogenerateinsertbutton="true" autogeneraterows="true" allowpaging="true" oniteminserted="CustomerDetailsView_ItemInserted" runat="server"> <fieldheaderstyle backcolor="Navy" forecolor="White"/> </asp:detailsview> <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="DetailsViewSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" insertcommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)" connectionstring= "<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.EventArgs
System.Web.UI.WebControls.DetailsViewInsertedEventArgs
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DetailsViewInsertedEventArgs コンストラクタ
アセンブリ: System.Web (system.web.dll 内)
構文Dim affectedRows As Integer Dim e As Exception Dim instance As New DetailsViewInsertedEventArgs(affectedRows, e)
解説このコンストラクタを使用して、DetailsViewInsertedEventArgs クラスの新しいインスタンスを初期化します。
DetailsViewInsertedEventArgs のインスタンスの初期プロパティ値を次の表に示します。
| AffectedRows | affectedRows パラメータの値。 |
| ExceptionHandled | |
| KeepInInsertMode |
.gif) メモ |
|---|
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DetailsViewInsertedEventArgs プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | AffectedRows | 挿入操作の影響を受けた行の数を取得します。 |
| | Exception | 挿入操作中に例外が発生した場合は、その例外を取得します。 |
| | ExceptionHandled | 挿入操作中に発生した例外がイベント ハンドラで処理されたかどうかを示す値を取得または設定します。 |
| | KeepInInsertMode | 挿入操作の後で、DetailsView コントロールを挿入モードのまま維持するかどうかを示す値を取得または設定します。 |
| | Values | 挿入されたレコードのフィールドの名前/値ペアを格納しているディクショナリを取得します。 |
参照DetailsViewInsertedEventArgs メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照DetailsViewInsertedEventArgs メンバ
DetailsViewInsertedEventArgs データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| | AffectedRows | 挿入操作の影響を受けた行の数を取得します。 |
| | Exception | 挿入操作中に例外が発生した場合は、その例外を取得します。 |
| | ExceptionHandled | 挿入操作中に発生した例外がイベント ハンドラで処理されたかどうかを示す値を取得または設定します。 |
| | KeepInInsertMode | 挿入操作の後で、DetailsView コントロールを挿入モードのまま維持するかどうかを示す値を取得または設定します。 |
| | 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 から継承されます。) |
参照- DetailsViewInsertedEventArgsのページへのリンク
