SqlDataSource.Insert メソッド
メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。 InsertCommand SQL 文字列と InsertParameters コレクション内にある任意のパラメータを使用して、挿入操作を実行します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
戻り値
基になるデータベースに挿入された行数を表す値。
例外
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As SqlDataSource Dim returnValue As Integer returnValue = instance.Insert
基になるデータベースに挿入された行数を表す値。
例外解説挿入操作を実行する前に、OnInserting メソッドが呼び出されて Inserting イベントが発生します。このイベントを処理してパラメータの値を調べ、Insert 操作の前に処理を実行できます。挿入操作を実行するために、SqlDataSourceView オブジェクトは、InsertCommand テキストと関連する任意の InsertParameters プロパティを使用して、DbCommand オブジェクトを構築し、基になるデータベースに対して DbCommand オブジェクトを実行します。
操作が完了した後、OnInserted メソッドが呼び出されて Inserted イベントが発生します。このイベントを処理することにより、戻り値とエラー コードを調べ、後処理を実行できます。
Insert メソッドは、Insert メソッドにプログラムによってアクセスするために用意されています。SqlDataSource コントロールがデータ バインド コントロールに関連付けられている場合、データ バインド コントロールにより自動的に Insert メソッドが呼び出されます。
Insert メソッドは、SqlDataSource コントロールに関連付けられた SqlDataSourceView の Insert メソッドに処理を代行させます。
使用例-
SqlDataSource コントロールと簡単な Web フォーム ページを使用してデータベースにデータを挿入する方法を次のコード例に示します。データ テーブル内の現在のデータが、DropDownList コントロールに表示されます。TextBox コントロールに値を入力し、[挿入] ボタンをクリックすることにより、新しいレコードを追加できます。[挿入] ボタンがクリックされると、指定された値がデータベースに挿入され、DropDownList が更新されます。
<%@Page Language="VB" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <Script runat="server"> Private Sub InsertShipper (ByVal Source As Object, ByVal e As EventArgs) SqlDataSource1.Insert() End Sub ' InsertShipper </Script> <HTML> <BODY> <FORM runat="server"> <asp:dropdownlist id="DropDownList1" runat="server" datasourceid="SqlDataSource1" datatextfield="CompanyName" datavaluefield="ShipperID" /> <!-- Security Note: The SqlDataSource uses a FormParameter, Security Note: which does not perform validation of input from the client. Security Note: To validate the value of the FormParameter, handle the Inserting event. --> <asp:sqldatasource id="SqlDataSource1" runat="server" connectionstring="<%$ ConnectionStrings:MyNorthwind %>" selectcommand="SELECT CompanyName,ShipperID FROM Shippers" insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)"> <insertparameters> <asp:formparameter name="CoName" formfield="CompanyNameBox" /> <asp:formparameter name="Phone" formfield="PhoneBox" /> </insertparameters> </asp:sqldatasource> <p><asp:textbox id="CompanyNameBox" runat="server" /> <asp:RequiredFieldValidator id="RequiredFieldValidator1" runat="server" ControlToValidate="CompanyNameBox" Display="Static" ErrorMessage="Please enter a company name." /> <p><asp:textbox id="PhoneBox" runat="server" /> <asp:RequiredFieldValidator id="RequiredFieldValidator2" runat="server" ControlToValidate="PhoneBox" Display="Static" ErrorMessage="Please enter a phone number." /> <p><asp:button id="Button1" runat="server" text="Insert New Shipper" onclick="InsertShipper" /> </FORM> </BODY> </HTML>
<%@Page Language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <Script runat="server"> private void InsertShipper (object source, EventArgs e) { SqlDataSource1.Insert(); } </Script> <HTML> <BODY> <FORM runat="server"> <asp:dropdownlist id="DropDownList1" runat="server" datasourceid="SqlDataSource1" datatextfield="CompanyName" datavaluefield="ShipperID" /> <!-- Security Note: The SqlDataSource uses a FormParameter, Security Note: which does not perform validation of input from the client. Security Note: To validate the value of the FormParameter, handle the Inserting event. --> <asp:sqldatasource id="SqlDataSource1" runat="server" connectionstring="<%$ ConnectionStrings:MyNorthwind %>" selectcommand="SELECT CompanyName,ShipperID FROM Shippers" insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName ,@Phone)"> <insertparameters> <asp:formparameter name="CoName" formfield="CompanyNameBox" /> <asp:formparameter name="Phone" formfield="PhoneBox" /> </insertparameters> </asp:sqldatasource> <p><asp:textbox id="CompanyNameBox" runat="server" /> <asp:RequiredFieldValidator id="RequiredFieldValidator1" runat="server" ControlToValidate="CompanyNameBox" Display="Static" ErrorMessage="Please enter a company name." /> <p><asp:textbox id="PhoneBox" runat="server" /> <asp:RequiredFieldValidator id="RequiredFieldValidator2" runat="server" ControlToValidate="PhoneBox" Display="Static" ErrorMessage="Please enter a phone number." /> <p><asp:button id="Button1" runat="server" text="Insert New Shipper" onclick="InsertShipper" /> </FORM> </BODY> </HTML>
<%@Page Language="VJ#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <Script runat="server"> private void InsertShipper(Object source, System.EventArgs e) { SqlDataSource1.Insert(); } //InsertShipper </Script> <HTML> <BODY> <FORM runat="server"> <asp:dropdownlist id="DropDownList1" runat="server" datasourceid="SqlDataSource1" datatextfield="CompanyName" datavaluefield="ShipperID" /> <asp:sqldatasource id="SqlDataSource1" runat="server" connectionstring="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;Connect Timeout=15" selectcommand="SELECT CompanyName,ShipperID FROM Shippers" insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName ,@Phone)"> <insertparameters> <asp:formparameter name="CoName" formfield="CompanyNameBox" /> <asp:formparameter name="Phone" formfield="PhoneBox" /> </insertparameters> </asp:sqldatasource> <p><asp:textbox id="CompanyNameBox" runat="server" /> <asp:RequiredFieldValidator id="RequiredFieldValidator1" runat="server" ControlToValidate="CompanyNameBox" Display="Static" ErrorMessage="Please enter a company name." /> <p><asp:textbox id="PhoneBox" runat="server" /> <asp:RequiredFieldValidator id="RequiredFieldValidator2" runat="server" ControlToValidate="PhoneBox" Display="Static" ErrorMessage="Please enter a phone number." /> <p><asp:button id="Button1" runat="server" text="Insert New Shipper" onclick="InsertShipper" /> </FORM> </BODY> </HTML>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- SqlDataSource.Insert メソッドのページへのリンク
