ParameterCollection クラス

リファレンス

定義

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

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

重要

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

高度なデータバインディングシナリオでデータソースコントロールによって使用される、Parameter および Parameter 派生オブジェクトのコレクションを表します。

public ref class ParameterCollection : System::Web::UI::StateManagedCollection

public class ParameterCollection : System.Web.UI.StateManagedCollection

type ParameterCollection = class
    inherit StateManagedCollection

Public Class ParameterCollection
Inherits StateManagedCollection

継承: Object

StateManagedCollection
ParameterCollection

例

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

重要

この例には、ユーザー入力を受け付けるテキストボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、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>

注釈

クラスは ParameterCollection 、データソースコントロールを使用する高度なデータバインディングシナリオで使用されるオブジェクトのコレクション Parameter を表します。オブジェクトは Parameter 、ローカル Page 変数、HTTP Cookie、セッション変数、およびその他のコントロールの値に含まれる値を、データの取得、更新、削除、および挿入時にデータソースコントロールにバインドするために使用されます。

クラスを ParameterCollection 使用して、一連の Parameter オブジェクトをプログラムで管理します。クラスの適切なメソッドParameterCollectionを使用して、オブジェクトを追加、挿入、および削除Parameterできます。プログラムによってコレクションからオブジェクトを取得 Parameter するには、次のいずれかの方法を使用します。

インデクサーを使用して、名前または配列表記を使用して、コレクションから 1 つの Parameter オブジェクトを取得します。
メソッドを GetEnumerator 使用して-implemented オブジェクトを System.Collections.IEnumerator作成し、それを使用してコレクションから項目を取得できます。

プロパティは Count 、コレクション内の項目の合計数を指定し、コレクションの上限を決定するために使用されます。、およびの各メソッドを使用して、コレクションの項目をAdd Insert Remove追加およびRemoveAt削除できます。

特定のデータソースコントロールの実装とセマンティクスによっては、パラメーターがコレクションに格納される ParameterCollection 順序が重要になる場合があります。たとえば、ODBC データソースとしてコントロールをSqlDataSource使用する場合、コレクション内ParameterCollectionのオブジェクトのParameter順序は、使用するパラメーター化された SQL クエリのパラメーターの順序と同じである必要があります。ただし、Microsoft SQL Server でコントロールをSqlDataSource使用する場合、オブジェクトのParameter順序は重要ではありません。

重要

データソースコントロールを使用すると、値は検証なしでコマンドパラメーターに挿入されます。これは、セキュリティ上の脅威になる可能性があります。コマンドを実行する前に、データソースコントロールのイベントを使用してパラメーター値を検証します。詳細については、「スクリプトによる攻略の概要」を参照してください。

次の表に、さまざまなパラメータークラスとその使用方法を示します。

Parameter クラス	[説明]
Parameter	基本パラメータークラス。これを使用して、プロパティを使用してローカル変数または任意の静的文字列に DefaultValue バインドします。
ControlParameter	コントロールのプロパティまたはメソッドの戻り値にバインドするために使用できるパラメーター。
CookieParameter	Cookie の値にバインドするために使用できるパラメーター。
FormParameter	現在のWeb Forms ページの属性にバインドするために使用できるパラメーター。
QueryStringParameter	クエリ文字列のWeb Forms ページに渡される値にバインドするために使用できるパラメーター。
SessionParameter	セッション変数の値にバインドするために使用できるパラメーター。
ProfileParameter	ASP.NET Profile プロパティの値にバインドするために使用できるパラメーター。

コンストラクター

ParameterCollection()

継承クラスインスタンスによって使用されるクラスを初期化します。このコンストラクターは、継承クラスによってのみ呼び出すことができます。

プロパティ

Count	StateManagedCollection コレクションに格納されている要素の数を取得します。 (継承元 StateManagedCollection)
Item[Int32]	コレクション内の指定したインデックスでの Parameter オブジェクトを取得または設定します。
Item[String]	コレクション内の指定した名前の Parameter オブジェクトを取得または設定します。

メソッド

Add(Parameter)	指定した Parameter オブジェクトをコレクションの末尾に追加します。
Add(String, DbType, String)	名前、データベース型、および既定値を指定して Parameter オブジェクトを作成し、コレクションの末尾に追加します。
Add(String, String)	名前と既定値を指定して Parameter オブジェクトを作成し、コレクションの末尾に追加します。
Add(String, TypeCode, String)	名前、Parameter、および既定値を指定して TypeCode オブジェクトを作成し、コレクションの末尾に追加します。
Clear()	StateManagedCollection コレクションからすべての項目を削除します。 (継承元 StateManagedCollection)
Contains(Parameter)	ParameterCollection コレクションに特定の値が格納されているかどうかを判断します。
CopyTo(Array, Int32)	特定の配列インデックスを開始位置として、配列に StateManagedCollection コレクションの要素をコピーします。 (継承元 StateManagedCollection)
CopyTo(Parameter[], Int32)	パラメーター配列の指定したインデックスをパラメーターコレクションにコピーします。
CreateKnownType(Int32)	既定の Parameter オブジェクトのインスタンスを作成します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetEnumerator()	StateManagedCollection コレクションを反復処理する反復子を返します。 (継承元 StateManagedCollection)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetKnownTypes()	Parameter コレクションに格納できる ParameterCollection 型の配列を取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValues(HttpContext, Control)	コレクションに現在格納されている Parameter オブジェクトの名前と対応する値の順序付けられたコレクションを取得します。
IndexOf(Parameter)	Parameter コレクション内の指定した ParameterCollection オブジェクトのインデックスを確認します。
Insert(Int32, Parameter)	Parameter コレクション内の指定したインデックス位置に、指定した ParameterCollection オブジェクトを挿入します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnClear()	派生クラスでオーバーライドされた場合、Clear() メソッドによってコレクションからすべての項目が削除される前の補足作業を実行します。 (継承元 StateManagedCollection)
OnClearComplete()	コレクションの内容を消去した後に、追加のカスタムプロセスを実行します。
OnInsert(Int32, Object)	Insert(Int32, Parameter) メソッドが呼び出される前に発生します。
OnInsertComplete(Int32, Object)	Insert(Int32, Parameter) メソッドの完了後に発生します。
OnParametersChanged(EventArgs)	ParametersChanged イベントを発生させます。
OnRemove(Int32, Object)	派生クラスでオーバーライドされた場合、IList.Remove(Object) メソッドまたは IList.RemoveAt(Int32) メソッドによって、指定された項目がコレクションから削除される前の補足作業を実行します。 (継承元 StateManagedCollection)
OnRemoveComplete(Int32, Object)	Remove(Parameter) メソッドの完了後に発生します。
OnValidate(Object)	値を検証するときに、追加のカスタムプロセスを実行します。
Remove(Parameter)	指定した Parameter オブジェクトを ParameterCollection コレクションから削除します。
RemoveAt(Int32)	指定したインデックス位置にある Parameter オブジェクトを ParameterCollection コレクションから削除します。
SetDirty()	強制的に StateManagedCollection コレクション全体をビューステートにシリアル化します。 (継承元 StateManagedCollection)
SetDirtyObject(Object)	ビューステートから最後に読み込まれた後または保存された後に変更されたものとして、指定した Parameter オブジェクトをマークします。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
UpdateValues(HttpContext, Control)	コレクションに格納された Parameter オブジェクトを反復処理し、各オブジェクトに対して `Evaluate` メソッドを呼び出します。

イベント

ParametersChanged

コレクションに格納された 1 つ以上の Parameter オブジェクトの状態が変更されたときに発生します。

明示的なインターフェイスの実装

ICollection.Count	StateManagedCollection コレクションに格納されている要素の数を取得します。 (継承元 StateManagedCollection)
ICollection.IsSynchronized	StateManagedCollection コレクションが同期されている (スレッドセーフである) かどうかを示す値を取得します。このメソッドは、常に `false` を返します。 (継承元 StateManagedCollection)
ICollection.SyncRoot	StateManagedCollection コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。このメソッドは、常に `null` を返します。 (継承元 StateManagedCollection)
IEnumerable.GetEnumerator()	StateManagedCollection コレクションを反復処理する反復子を返します。 (継承元 StateManagedCollection)
IList.Add(Object)	項目を StateManagedCollection コレクションに追加します。 (継承元 StateManagedCollection)
IList.Clear()	StateManagedCollection コレクションからすべての項目を削除します。 (継承元 StateManagedCollection)
IList.Contains(Object)	StateManagedCollection コレクションに特定の値が格納されているかどうかを判断します。 (継承元 StateManagedCollection)
IList.IndexOf(Object)	StateManagedCollection コレクション内での指定した項目のインデックスを調べます。 (継承元 StateManagedCollection)
IList.Insert(Int32, Object)	StateManagedCollection コレクション内の指定したインデックスの位置に項目を挿入します。 (継承元 StateManagedCollection)
IList.IsFixedSize	StateManagedCollection コレクションが固定サイズかどうかを示す値を取得します。このメソッドは、常に `false` を返します。 (継承元 StateManagedCollection)
IList.IsReadOnly	StateManagedCollection コレクションが読み取り専用かどうかを示す値を取得します。 (継承元 StateManagedCollection)
IList.Item[Int32]	指定されたインデックス位置の IStateManager 要素を取得します。 (継承元 StateManagedCollection)
IList.Remove(Object)	指定したオブジェクトのうち、StateManagedCollection コレクションで最初に出現したオブジェクトを削除します。 (継承元 StateManagedCollection)
IList.RemoveAt(Int32)	指定したインデックス位置にある IStateManager 要素を削除します。 (継承元 StateManagedCollection)
IStateManager.IsTrackingViewState	StateManagedCollection コレクションがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 StateManagedCollection)
IStateManager.LoadViewState(Object)	StateManagedCollection コレクションと、そのコレクションに格納されている IStateManager 項目の以前に保存されたビューステートを復元します。 (継承元 StateManagedCollection)
IStateManager.SaveViewState()	ページがサーバーにポストバックされた時間以降に発生した、StateManagedCollection コレクションとその各 IStateManager オブジェクトへの変更を保存します。 (継承元 StateManagedCollection)
IStateManager.TrackViewState()	StateManagedCollection コレクションとその各 IStateManager オブジェクトに自身のビューステートへの変更を追跡させ、同じページに対する要求間でこれらが永続化されるようにします。 (継承元 StateManagedCollection)

拡張メソッド

Cast<TResult>(IEnumerable)	IEnumerable の要素を、指定した型にキャストします。
OfType<TResult>(IEnumerable)	指定された型に基づいて IEnumerable の要素をフィルター処理します。
AsParallel(IEnumerable)	クエリの並列化を有効にします。
AsQueryable(IEnumerable)	IEnumerable を IQueryable に変換します。

適用対象