FormParameterとは？ わかりやすく解説

.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
C#
public class FormParameter : Parameter
C++
public ref class FormParameter : public
 Parameter
J#
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 に設定することによって、データ操作をキャンセルできます。

使用例使用例

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>
C#
<%@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>
J#
<%@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>
継承階層継承階層
System.Object
   System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.FormParameter
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム

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
参照参照
関連項目
FormParameter メンバ
System.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
ProfileParameter
QueryStringParameter
SessionParameter
その他の技術情報
ASP.NET データ アクセスの概要
データ ソース コントロールとパラメータの使用

FormParameter コンストラクタ ()

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

FormParameter クラスの名前のない新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New FormParameter
C#
public FormParameter ()
C++
public:
FormParameter ()
J#
public FormParameter ()
JScript
public function FormParameter ()
解説解説

FormParameter コンストラクタで作成された FormParameter オブジェクトは、すべてのプロパティに既定値を使用して初期化されます。FormField プロパティは String.Empty に初期化されます。また、Name プロパティは String.Empty に初期化され、Type プロパティは TypeCode.Object に初期化されます。さらに、Direction プロパティは Input に初期化され、DefaultValue プロパティは null (Visual Basic の場合は Nothing) に初期化されます。

使用例使用例
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 Page_Load(sender As
 Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the
 client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.
  Dim formParam As New FormParameter()
  formParam.Name="lastname"
  formParam.Type=TypeCode.String
  formParam.FormField="LastNameBox"
  AccessDataSource1.SelectParameters.Add(formParam)

End Sub ' Page_Load

</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE
 LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or
 "King" in the text box and
 click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1" />

    </FORM>
  </BODY>
</HTML>
C#
<%@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">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from
 the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter();
  formParam.Name="lastname";
  formParam.Type=TypeCode.String;
  formParam.FormField="LastNameBox";
  AccessDataSource1.SelectParameters.Add(formParam);
}
</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or "King" in
 the text box and click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1" />

    </FORM>
  </BODY>
</HTML>
J#
<%@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">

    void Page_Load(Object sender, System.EventArgs e)
    {
        // You can add a FormParameter to the AccessDataSource control's
        // SelectParameters collection programmatically.
        accessDataSource1.get_SelectParameters().Clear();

        FormParameter formParam = new FormParameter();

        formParam.set_Name("lastname");
        formParam.set_Type(System.TypeCode.String);
        formParam.set_FormField("LastNameBox");
        accessDataSource1.get_SelectParameters().Add(formParam);
    }//Page_Load
</SCRIPT>
<HTML>
  <BODY>
    <form id="Form1" runat="server">

      <asp:accessdatasource
          id="accessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
          FROM Orders WHERE EmployeeID = (SELECT EmployeeID FROM Employees WHERE
 LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or "King" in
 the text box and click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="accessDataSource1">
      </asp:gridview>

    </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
参照参照
関連項目
FormParameter クラス
FormParameter メンバ
System.Web.UI.WebControls 名前空間

FormParameter コンストラクタ (String, TypeCode, String)

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

バインド先のフォーム変数を識別する文字列を指定して、FormParameter クラスの厳密に型指定された名前付きの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    type As TypeCode, _
    formField As String _
)
Visual Basic (使用法)
Dim name As String
Dim type As TypeCode
Dim formField As String

Dim instance As New FormParameter(name,
 type, formField)
C#
public FormParameter (
    string name,
    TypeCode type,
    string formField
)
C++
public:
FormParameter (
    String^ name, 
    TypeCode type, 
    String^ formField
)
J#
public FormParameter (
    String name, 
    TypeCode type, 
    String formField
)
JScript
public function FormParameter (
    name : String, 
    type : TypeCode, 
    formField : String
)

パラメータ

name

パラメータの名前。

type

パラメータが表す型。既定値は Object です。

formField

パラメータ オブジェクトのバインド先のフォーム変数の名前。既定値は Empty です。

解説解説

FormParameter コンストラクタを使用して作成された FormParameter オブジェクトは、指定されたパラメータ名、Type、およびパラメータのバインド先のフォーム変数を識別する文字列を使用して初期化されます。Direction プロパティおよび ConvertEmptyStringToNull プロパティだけが既定値で初期化されます。

使用例使用例
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 Page_Load(sender As
 Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the
 client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname"
,TypeCode.String,"LastNameBox")
  AccessDataSource1.SelectParameters.Add(formParam)

End Sub ' Page_Load

</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                           (SELECT EmployeeID FROM Employees WHERE
 LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or
 "King" in the text box and
 click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </FORM>
  </BODY>
</HTML>
C#
<%@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">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from
 the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname",
 TypeCode.String, "LastNameBox");
  AccessDataSource1.SelectParameters.Add(formParam);
}

</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                          (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or "King" in
 the text box and click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </FORM>
  </BODY>
</HTML>
J#
<%@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">
    void Page_Load(Object sender, System.EventArgs e)
    {
        // You can add a FormParameter to the AccessDataSource control's
        // SelectParameters collection programmatically.
        AccessDataSource1.get_SelectParameters().Clear();
        FormParameter formParam = new FormParameter("lastname",
 
            System.TypeCode.String, "LastNameBox");
        AccessDataSource1.get_SelectParameters().Add(formParam);
    } //Page_Load
</SCRIPT>
<HTML>
  <BODY>
    <form id="Form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate
,ShippedDate
          FROM Orders WHERE EmployeeID = (SELECT EmployeeID FROM Employees WHERE
 LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or "King" in
 the text box and click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </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
参照参照
関連項目
FormParameter クラス
FormParameter メンバ
System.Web.UI.WebControls 名前空間
Name
FormField

FormParameter コンストラクタ (String, String)

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

バインド先のフォーム変数フィールドを識別する文字列を指定して、FormParameter クラスの名前付きの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    formField As String _
)
Visual Basic (使用法)
Dim name As String
Dim formField As String

Dim instance As New FormParameter(name,
 formField)
C#
public FormParameter (
    string name,
    string formField
)
C++
public:
FormParameter (
    String^ name, 
    String^ formField
)
J#
public FormParameter (
    String name, 
    String formField
)
JScript
public function FormParameter (
    name : String, 
    formField : String
)

パラメータ

name

パラメータの名前。

formField

パラメータ オブジェクトのバインド先のフォーム変数の名前。既定値は Empty です。

解説解説

FormParameter コンストラクタを使用して作成された FormParameter オブジェクトは、指定されたパラメータ名、およびパラメータのバインド先のフォーム変数を識別する文字列を使用して初期化されます。Direction プロパティおよび Type プロパティは、既定値で初期化されます。

使用例使用例
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 Page_Load(sender As
 Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the
 client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname"
,"LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE
 LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or
 "King" in the text box and
 click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </FORM>
  </BODY>
</HTML>
C#
<%@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">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from
 the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname"
,"LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or "King" in
 the text box and click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </FORM>
  </BODY>
</HTML>
J#
<%@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">
    void Page_Load(Object sender, System.EventArgs e)
    {
        // You can add a FormParameter to the AccessDataSource control's
        // SelectParameters collection programmatically.
        AccessDataSource1.get_SelectParameters().Clear();

        FormParameter formParam = new FormParameter("lastname",
 "LastNameBox");

        formParam.set_Type(System.TypeCode.String);
        AccessDataSource1.get_SelectParameters().Add(formParam);
    } //Page_Load
</SCRIPT>
<HTML>
  <BODY>
    <form id="Form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
          FROM Orders WHERE EmployeeID = (SELECT EmployeeID FROM Employees WHERE
 LastName = @lastname)">
      </asp:accessdatasource>

      <p>Enter the name "Davolio" or "King" in
 the text box and click the button.

      <p>
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <p>
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <p>
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </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
参照参照
関連項目
FormParameter クラス
FormParameter メンバ
System.Web.UI.WebControls 名前空間
Name
FormField

FormParameter コンストラクタ

FormParameter クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
FormParameter () FormParameter クラスの名前のない新しいインスタンスを初期化します。
FormParameter (FormParameter) original パラメータによってインスタンスの値を指定して、FormParameter クラスの新しいインスタンスを初期化します。
FormParameter (String, String) バインド先のフォーム変数フィールドを識別する文字列を指定して、FormParameter クラスの名前付きの新しいインスタンスを初期化します。
FormParameter (String, TypeCode, String) バインド先のフォーム変数を識別する文字列を指定して、FormParameter クラスの厳密に型指定された名前付きの新しいインスタンスを初期化します。
参照参照

関連項目

FormParameter クラス
FormParameter メンバ
System.Web.UI.WebControls 名前空間

FormParameter コンストラクタ (FormParameter)

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

original パラメータによってインスタンスの値を指定して、FormParameter クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Protected Sub New ( _
    original As FormParameter _
)
Visual Basic (使用法)
Dim original As FormParameter

Dim instance As New FormParameter(original)
C#
protected FormParameter (
    FormParameter original
)
C++
protected:
FormParameter (
    FormParameter^ original
)
J#
protected FormParameter (
    FormParameter original
)
JScript
protected function FormParameter (
    original : FormParameter
)

パラメータ

original

現在のインスタンスの初期化元になる FormParameter インスタンス。

解説解説

FormParameter コンストラクタは、FormParameter インスタンスの複製を作成するための protected コピー コンストラクタです。FormParameter の値 (FormField、Name、Type など) が、すべて新しいインスタンスに転送されます。

プラットフォームプラットフォーム

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
参照参照
関連項目
FormParameter クラス
FormParameter メンバ
System.Web.UI.WebControls 名前空間
Clone

FormParameter プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ ConvertEmptyStringToNull  Parameter オブジェクトのバインド先の値が String.Empty の場合に、その値を null 参照 (Visual Basic では Nothing) に変換する必要があるかどうかを示す値を取得または設定します。 ( Parameter から継承されます。)
パブリック プロパティ DefaultValue  パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。 ( Parameter から継承されます。)
パブリック プロパティ Direction  Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。 ( Parameter から継承されます。)
パブリック プロパティ FormField パラメータのバインド先のフォーム変数の名前を取得または設定します。
パブリック プロパティ Name  パラメータの名前を取得または設定します。 ( Parameter から継承されます。)
パブリック プロパティ Size  パラメータのサイズを取得または設定します。 ( Parameter から継承されます。)
パブリック プロパティ Type  パラメータの型を取得または設定します。 ( Parameter から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ IsTrackingViewState  Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 ( Parameter から継承されます。)
プロテクト プロパティ ViewState  同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 ( Parameter から継承されます。)
参照参照

関連項目

FormParameter クラス
System.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
ProfileParameter
QueryStringParameter
SessionParameter

その他の技術情報

ASP.NET データ アクセスの概要
データ ソース コントロールとパラメータの使用

FormParameter メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  このインスタンスの値を、それと等価の文字列形式に変換します。 ( Parameter から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Clone オーバーライドされます。 現在の FormParameter インスタンスの複製を返します。
プロテクト メソッド Evaluate オーバーライドされます。 FormParameter オブジェクトの値を更新して返します。
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド LoadViewState  データ ソース ビューの、以前保存したビューステートを復元します。 ( Parameter から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
プロテクト メソッド OnParameterChanged  Parameter オブジェクトを格納する ParameterCollection コレクションの OnParametersChanged メソッドを呼び出します。 ( Parameter から継承されます。)
プロテクト メソッド SaveViewState  ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 ( Parameter から継承されます。)
プロテクト メソッド SetDirty  Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 ( Parameter から継承されます。)
プロテクト メソッド TrackViewState  Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 ( Parameter から継承されます。)
参照参照

関連項目

FormParameter クラス
System.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
ProfileParameter
QueryStringParameter
SessionParameter

その他の技術情報

ASP.NET データ アクセスの概要
データ ソース コントロールとパラメータの使用

FormParameter メンバ

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

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


パブリック コンストラクタパブリック コンストラクタ
( プロテクト コンストラクタ も参照)
  名前 説明
パブリック メソッド FormParameter オーバーロードされます。 FormParameter クラスの新しいインスタンスを初期化します。
プロテクト コンストラクタプロテクト コンストラクタ
  名前 説明
プロテクト メソッド FormParameter オーバーロードされます。 FormParameter クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ ConvertEmptyStringToNull  Parameter オブジェクトのバインド先の値が String.Empty の場合に、その値を null 参照 (Visual Basic では Nothing) に変換する必要があるかどうかを示す値を取得または設定します。(Parameter から継承されます。)
パブリック プロパティ DefaultValue  パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。(Parameter から継承されます。)
パブリック プロパティ Direction  Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。(Parameter から継承されます。)
パブリック プロパティ FormField パラメータのバインド先のフォーム変数の名前を取得または設定します。
パブリック プロパティ Name  パラメータの名前を取得または設定します。(Parameter から継承されます。)
パブリック プロパティ Size  パラメータのサイズを取得または設定します。(Parameter から継承されます。)
パブリック プロパティ Type  パラメータの型を取得または設定します。(Parameter から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ IsTrackingViewState  Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。(Parameter から継承されます。)
プロテクト プロパティ ViewState  同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。(Parameter から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  このインスタンスの値を、それと等価の文字列形式に変換します。 (Parameter から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Clone オーバーライドされます。 現在の FormParameter インスタンスの複製を返します。
プロテクト メソッド Evaluate オーバーライドされます。 FormParameter オブジェクトの値を更新して返します。
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド LoadViewState  データ ソース ビューの、以前保存したビューステートを復元します。 (Parameter から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
プロテクト メソッド OnParameterChanged  Parameter オブジェクトを格納する ParameterCollection コレクションの OnParametersChanged メソッドを呼び出します。 (Parameter から継承されます。)
プロテクト メソッド SaveViewState  ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 (Parameter から継承されます。)
プロテクト メソッド SetDirty  Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 (Parameter から継承されます。)
プロテクト メソッド TrackViewState  Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 (Parameter から継承されます。)
参照参照

関連項目

FormParameter クラス
System.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
ProfileParameter
QueryStringParameter
SessionParameter

その他の技術情報

ASP.NET データ アクセスの概要
データ ソース コントロールとパラメータの使用

急上昇のことば

いつも月夜に米の飯
囮
太刀筋
破天荒
バタバタする
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「FormParameter」の関連用語

1
FormParameter.Clone メソッド
.NET Framework クラス ライブラリ リファレンス
72% |||||

2
FormParameter コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
58% |||||

3
FormParameter クラス
.NET Framework クラス ライブラリ リファレンス
54% |||||

4
FormParameter.Evaluate メソッド
.NET Framework クラス ライブラリ リファレンス
38% |||||

5
ParameterCollection.Item プロパティ
.NET Framework クラス ライブラリ リファレンス
38% |||||

6
ParameterCollection クラス
.NET Framework クラス ライブラリ リファレンス
36% |||||

7
SqlDataSource.Insert メソッド
.NET Framework クラス ライブラリ リファレンス
36% |||||

8
SqlDataSource.InsertParameters プロパティ
.NET Framework クラス ライブラリ リファレンス
36% |||||

9
SqlDataSourceView.InsertParameters プロパティ
.NET Framework クラス ライブラリ リファレンス
36% |||||

10
ObjectDataSourceView.UpdateParameters プロパティ
.NET Framework クラス ライブラリ リファレンス
34% |||||

FormParameterのお隣キーワード

Form.ProcessDialogKey メソッド

Form.ProcessKeyPreview メソッド

Form.ProcessMnemonic メソッド

Form.ProcessTabKey メソッド

Form.RaisePostBackEvent メソッド

Form.RemoveOwnedForm メソッド

FormParameter

FormParameter クラス

FormParameter コンストラクタ

FormParameter プロパティ

FormParameter メソッド

FormParameter メンバ

FormParameter.Clone メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


FormParameterのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS