ParameterCollection.Add メソッド

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Parameter オブジェクトをコレクションに追加します。

オーバーロード

名前	説明
Add(Parameter)	指定した Parameter オブジェクトをコレクションの末尾に追加します。
Add(String, String)	指定した名前と既定値を持つ Parameter オブジェクトを作成し、コレクションの末尾に追加します。
Add(String, DbType, String)	指定した名前、データベースの種類、既定値を持つ Parameter オブジェクトを作成し、コレクションの末尾に追加します。
Add(String, TypeCode, String)	指定した名前、Parameter、既定値を持つTypeCode オブジェクトを作成し、コレクションの末尾に追加します。

Add(Parameter)

指定した Parameter オブジェクトをコレクションの末尾に追加します。

public:
 int Add(System::Web::UI::WebControls::Parameter ^ parameter);

public int Add(System.Web.UI.WebControls.Parameter parameter);

member this.Add : System.Web.UI.WebControls.Parameter -> int

Public Function Add (parameter As Parameter) As Integer

パラメーター

parameter: Parameter

コレクションに追加する Parameter 。

返品

Int32

追加された項目のインデックス値。

例

次のコード例では、AccessDataSource コントロールと FormParameter オブジェクトを使用して、GridView コントロール内のMicrosoft Access データベースからの情報を表示する方法を示します。 FormParameter オブジェクトは、SelectParameters メソッドを使用してAdd(Parameter) コレクションに追加されます。

Important

この例には、潜在的なセキュリティ上の脅威であるユーザー入力を受け入れるテキストボックスがあります。既定では、ASP.NET Web ページでは、ユーザー入力にスクリプトや 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">

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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<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>

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

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

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

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

    </form>
  </body>
</html>

<%@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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<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>

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

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

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

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

    </form>
  </body>
</html>

注釈

Add(Parameter) メソッドを使用して、Parameter オブジェクトをコレクションの末尾に追加します。このメソッドの実装では、Parameter パラメーターで指定されたparam オブジェクトを受け取り、コレクションに追加します。

こちらもご覧ください

適用対象

Add(String, String)

指定した名前と既定値を持つ Parameter オブジェクトを作成し、コレクションの末尾に追加します。

public:
 int Add(System::String ^ name, System::String ^ value);

public int Add(string name, string value);

member this.Add : string * string -> int

Public Function Add (name As String, value As String) As Integer

パラメーター

name: String

パラメーターの名前。

value: String

パラメーターの既定値として機能する文字列。

返品

Int32

追加された項目のインデックス値。

注釈

Add(String, String) メソッドを使用して、既定値を持つParameter オブジェクトを作成し、コレクションの末尾に追加します。このメソッドの実装では、Parameter パラメーターとname パラメーターで指定された名前と既定値を使用して、value オブジェクトを作成し、コレクションに追加します。

こちらもご覧ください

Parameter

適用対象

Add(String, DbType, String)

指定した名前、データベースの種類、既定値を持つ Parameter オブジェクトを作成し、コレクションの末尾に追加します。

public:
 int Add(System::String ^ name, System::Data::DbType dbType, System::String ^ value);

public int Add(string name, System.Data.DbType dbType, string value);

member this.Add : string * System.Data.DbType * string -> int

Public Function Add (name As String, dbType As DbType, value As String) As Integer

パラメーター

name: String

パラメーターの名前。

dbType: DbType

パラメーターのデータベース型。

value: String

パラメーターの既定値。

返品

Int32

追加された項目のインデックス値。

注釈

このメソッドはデータベース型用です。 CLR 型には Add(String, TypeCode, String) メソッドを使用します。

適用対象

Add(String, TypeCode, String)

指定した名前、Parameter、既定値を持つTypeCode オブジェクトを作成し、コレクションの末尾に追加します。

public:
 int Add(System::String ^ name, TypeCode type, System::String ^ value);

public int Add(string name, TypeCode type, string value);

member this.Add : string * TypeCode * string -> int

Public Function Add (name As String, type As TypeCode, value As String) As Integer

パラメーター

name: String

パラメーターの名前。

type: TypeCode

パラメーターの型。

value: String

パラメーターの既定値。

返品

Int32

追加された項目のインデックス値。

注釈

Add(String, TypeCode, String) メソッドを使用して、厳密に型指定されたParameter オブジェクトを作成し、既定値を持つオブジェクトをコレクションの末尾に追加します。このメソッドの実装では、Parameter、name、および type の各パラメーターで指定された名前、型、および値を使用して、value オブジェクトを作成し、コレクションに追加します。

こちらもご覧ください

Parameter

適用対象

フィードバック

このページはお役に立ちましたか?