FormParameter クラスとは何？わかりやすく解説 Weblio辞書

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

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

FormParameter クラス

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

HTTP 要求の Form フィールドの値をパラメータオブジェクトにバインドします。

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

Visual Basic (宣言)

Public Class FormParameter
    Inherits Parameter

Visual Basic (使用法)

Dim instance As FormParameter

public class FormParameter : Parameter

C++

public ref class FormParameter : public
 Parameter

public class FormParameter extends Parameter

JScript

public class FormParameter extends
 Parameter

解説

FormParameter クラスを使用して、Form コレクションのフォーム変数の値を、パラメータ付きのクエリまたはコマンドで使用するパラメータにバインドできます。FormParameter が指定されていても、対応する変数が渡されないと、データをパラメータにバインドするコントロールは例外をスローします。また、対応する値が渡されずに変数が渡された場合も、データは表示されません。このような状況を防ぐには、必要に応じて DefaultValue を設定します。

FormParameter クラスには、Parameter クラスから継承されたプロパティに加え、バインド先のフォーム変数の名前を識別する FormField プロパティが用意されています。

重要 :
FormParameter は、フォーム要素によって渡された値は一切検証せず、そのままの値を使用します。多くの場合、データソースコントロールで発生した Selecting、Updating、Inserting、Deleting などのイベントを処理することによって、FormParameter の値をデータソースコントロールで使用される前に検証できます。パラメータの値が検証に合格しなかった場合は、関連付けられた CancelEventArgs クラスの Cancel プロパティを true に設定することによって、データ操作をキャンセルできます。

重要 :

FormParameter は、フォーム要素によって渡された値は一切検証せず、そのままの値を使用します。多くの場合、データソースコントロールで発生した Selecting、Updating、Inserting、Deleting などのイベントを処理することによって、FormParameter の値をデータソースコントロールで使用される前に検証できます。パラメータの値が検証に合格しなかった場合は、関連付けられた CancelEventArgs クラスの Cancel プロパティを true に設定することによって、データ操作をキャンセルできます。

使用例

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>