SqlDataSource.InsertParameters プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlDataSource.InsertParameters プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

SqlDataSource コントロールに関連付けられた SqlDataSourceView オブジェクトから、InsertCommand プロパティで使用されるパラメータを格納するパラメータコレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 InsertParameters As ParameterCollection

Visual Basic (使用法)

Dim instance As SqlDataSource
Dim value As ParameterCollection

value = instance.InsertParameters

public ParameterCollection InsertParameters { get;
 }

C++

public:
property ParameterCollection^ InsertParameters {
    ParameterCollection^ get ();
}

/** @property */
public ParameterCollection get_InsertParameters ()

JScript

public function get InsertParameters
 () : ParameterCollection

プロパティ値
InsertCommand プロパティによって使用されるパラメータを格納している ParameterCollection。

解説

InsertParameters プロパティは、SqlDataSource コントロールに関連付けられた SqlDataSourceView オブジェクトが格納する InsertParameters プロパティを取得します。

InsertCommand プロパティにパラメータ化された SQL クエリが含まれている場合、InsertParameters コレクションには、SQL 文字列内のパラメータプレースホルダに対応する Parameter オブジェクトが含まれます。

ADO.NET プロバイダによっては、InsertParameters コレクションのパラメータの順序が重要になる場合があります。System.Data.OleDb プロバイダおよび System.Data.Odbc プロバイダは、コレクション内のパラメータをパラメータ化された SQL クエリでの指定順序に従って関連付けます。SqlDataSource コントロールの既定の ADO.NET プロバイダである System.Data.SqlClient プロバイダは、パラメータ名と、SQL クエリ内のプレースホルダエイリアスとを照らし合わせることにより、コレクション内のパラメータを関連付けます。パラメータ化された SQL クエリとコマンドの詳細については、「SqlDataSource コントロールにおけるパラメータの使用」を参照してください。

使用例

SqlDataSource コントロールと簡単な Web フォームページを使用してデータベースにデータを挿入する方法を次のコード例に示します。データテーブル内の現在のデータが、DropDownList コントロールに表示されます。TextBox コントロールに値を入力し、[挿入] ボタンをクリックすることにより、新しいレコードを追加できます。[挿入] ボタンがクリックされると、指定された値がデータベースに挿入され、DropDownList コントロールが更新されます。

Visual Basic

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlDataSource クラス
SqlDataSource メンバ
System.Web.UI.WebControls 名前空間
SqlDataSource.InsertCommand プロパティ
Insert

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

全ての辞書からSqlDataSource.InsertParameters プロパティを検索

>> 「SqlDataSource.InsertParameters プロパティ」を含む用語の索引
SqlDataSource.InsertParameters プロパティのページへのリンク


	© 2024 Microsoft.All rights reserved.

SqlDataSource.InsertParameters プロパティとは？ わかりやすく解説

SqlDataSource.InsertParameters プロパティ

急上昇のことば

SqlDataSource.InsertParameters プロパティとは？わかりやすく解説