乐胖代购免代理版

ParameterCollection イベント

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

参照

ParameterCollection クラス

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

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

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

Visual Basic (宣言)

Public Class ParameterCollection
    Inherits StateManagedCollection

Visual Basic (使用法)

Dim instance As ParameterCollection

public class ParameterCollection : StateManagedCollection

C++

public ref class ParameterCollection : public
 StateManagedCollection

public class ParameterCollection extends StateManagedCollection

JScript

public class ParameterCollection extends
 StateManagedCollection

解説

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

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

インデクサを使用して、名前または配列表記を指定することによってコレクションから単一の Parameter オブジェクトを取得します。
GetEnumerator メソッドを使用して System.Collections.IEnumerator 実装オブジェクトを作成することにより、このオブジェクトを使用して、コレクションから項目を取得できるようになります。

Count プロパティは、コレクション内の項目の総数を指定します。このプロパティを使用して、コレクションの上限を決定します。Add、Insert、Remove、および RemoveAt の各メソッドを使用して、コレクションへの項目の追加およびコレクションからの項目の削除を行うことができます。

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

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

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

使用例

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

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>

<%@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>

<%@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>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
System.Web.UI.StateManagedCollection
System.Web.UI.WebControls.ParameterCollection

スレッドセーフ

この型の 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

参照

関連項目
ParameterCollection メンバ
System.Web.UI.WebControls 名前空間
Parameter クラス
SqlDataSource
ObjectDataSource クラス
XmlDataSource

ParameterCollection コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ParameterCollection

public ParameterCollection ()

C++

public:
ParameterCollection ()

public ParameterCollection ()

JScript

public function ParameterCollection ()

プラットフォーム

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
サポート対象 : 2.0

参照

関連項目
ParameterCollection クラス
ParameterCollection メンバ
System.Web.UI.WebControls 名前空間

ParameterCollection プロパティ

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

	名前	説明
	Count	StateManagedCollection コレクションに格納されている要素の数を取得します。 ( StateManagedCollection から継承されます。)
	Item	オーバーロードされます。コレクション内の Parameter オブジェクトを取得または設定します。

参照

ParameterCollection メソッド

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

( プロテクトメソッドも参照)

	名前	説明
	Add	オーバーロードされます。 Parameter オブジェクトをコレクションに追加します。
	Clear	StateManagedCollection コレクションからすべての項目を削除します。 ( StateManagedCollection から継承されます。)
	Contains	ParameterCollection コレクションに特定の値が格納されているかどうかを確認します。
	CopyTo	オーバーロードされます。パラメータ配列の指定したインデックスをパラメータコレクションにコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	StateManagedCollection コレクションを反復処理する反復子を返します。 ( StateManagedCollection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetValues	コレクションに現在格納されている Parameter オブジェクトの名前と対応する値の順序付けられたコレクションを取得します。
	IndexOf	ParameterCollection コレクション内の指定した Parameter オブジェクトのインデックスを確認します。
	Insert	ParameterCollection コレクション内の指定したインデックス位置に、指定した Parameter オブジェクトを挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	指定した Parameter オブジェクトを ParameterCollection コレクションから削除します。
	RemoveAt	指定したインデックス位置にある Parameter オブジェクトを ParameterCollection コレクションから削除します。
	SetDirty	強制的に StateManagedCollection コレクション全体をビューステートにシリアル化します。 ( StateManagedCollection から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	UpdateValues	コレクションに格納された Parameter オブジェクトを反復処理し、各オブジェクトに対して Evaluate メソッドを呼び出します。

プロテクトメソッド

	名前	説明
	CreateKnownType	オーバーライドされます。既定の Parameter オブジェクトのインスタンスを作成します。
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetKnownTypes	オーバーライドされます。 ParameterCollection コレクションに格納できる Parameter 型の配列を取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnClear	派生クラスでオーバーライドされた場合、Clear メソッドによってコレクションからすべての項目が削除される前の補足作業を実行します。 ( StateManagedCollection から継承されます。)
	OnClearComplete	オーバーライドされます。コレクションの内容を消去した後に、追加のカスタムプロセスを実行します。
	OnInsert	オーバーライドされます。 Insert メソッドが呼び出される前に発生します。
	OnInsertComplete	オーバーライドされます。 Insert メソッドの完了後に発生します。
	OnParametersChanged	ParametersChanged イベントを発生させます。
	OnRemove	派生クラスでオーバーライドされた場合、System.Collections.IList.Remove メソッドまたは System.Collections.IList.RemoveAt メソッドによって、指定された項目がコレクションから削除される前の補足作業を実行します。 ( StateManagedCollection から継承されます。)
	OnRemoveComplete	オーバーライドされます。 Remove メソッドの完了後に発生します。
	OnValidate	オーバーライドされます。値を検証するときに、追加のカスタムプロセスを実行します。
	SetDirtyObject	オーバーライドされます。ビューステートから最後に読み込まれた後または保存された後に変更されたものとして、指定した Parameter オブジェクトをマークします。

参照

ParameterCollection メンバ

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

パブリックコンストラクタ

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

パブリックプロパティ

	名前	説明
	Count	StateManagedCollection コレクションに格納されている要素の数を取得します。(StateManagedCollection から継承されます。)
	Item	オーバーロードされます。コレクション内の Parameter オブジェクトを取得または設定します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	オーバーロードされます。 Parameter オブジェクトをコレクションに追加します。
	Clear	StateManagedCollection コレクションからすべての項目を削除します。 (StateManagedCollection から継承されます。)
	Contains	ParameterCollection コレクションに特定の値が格納されているかどうかを確認します。
	CopyTo	オーバーロードされます。パラメータ配列の指定したインデックスをパラメータコレクションにコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	StateManagedCollection コレクションを反復処理する反復子を返します。 (StateManagedCollection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetValues	コレクションに現在格納されている Parameter オブジェクトの名前と対応する値の順序付けられたコレクションを取得します。
	IndexOf	ParameterCollection コレクション内の指定した Parameter オブジェクトのインデックスを確認します。
	Insert	ParameterCollection コレクション内の指定したインデックス位置に、指定した Parameter オブジェクトを挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	指定した Parameter オブジェクトを ParameterCollection コレクションから削除します。
	RemoveAt	指定したインデックス位置にある Parameter オブジェクトを ParameterCollection コレクションから削除します。
	SetDirty	強制的に StateManagedCollection コレクション全体をビューステートにシリアル化します。 (StateManagedCollection から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	UpdateValues	コレクションに格納された Parameter オブジェクトを反復処理し、各オブジェクトに対して Evaluate メソッドを呼び出します。

プロテクトメソッド

	名前	説明
	CreateKnownType	オーバーライドされます。既定の Parameter オブジェクトのインスタンスを作成します。
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetKnownTypes	オーバーライドされます。 ParameterCollection コレクションに格納できる Parameter 型の配列を取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnClear	派生クラスでオーバーライドされた場合、Clear メソッドによってコレクションからすべての項目が削除される前の補足作業を実行します。 (StateManagedCollection から継承されます。)
	OnClearComplete	オーバーライドされます。コレクションの内容を消去した後に、追加のカスタムプロセスを実行します。
	OnInsert	オーバーライドされます。 Insert メソッドが呼び出される前に発生します。
	OnInsertComplete	オーバーライドされます。 Insert メソッドの完了後に発生します。
	OnParametersChanged	ParametersChanged イベントを発生させます。
	OnRemove	派生クラスでオーバーライドされた場合、System.Collections.IList.Remove メソッドまたは System.Collections.IList.RemoveAt メソッドによって、指定された項目がコレクションから削除される前の補足作業を実行します。 (StateManagedCollection から継承されます。)
	OnRemoveComplete	オーバーライドされます。 Remove メソッドの完了後に発生します。
	OnValidate	オーバーライドされます。値を検証するときに、追加のカスタムプロセスを実行します。
	SetDirtyObject	オーバーライドされます。ビューステートから最後に読み込まれた後または保存された後に変更されたものとして、指定した Parameter オブジェクトをマークします。

パブリックイベント

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

参照

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

ParameterCollection イベント

関連項目

ParameterCollection クラス

ParameterCollection コンストラクタ

ParameterCollection プロパティ

関連項目

ParameterCollection メソッド

関連項目

ParameterCollection メンバ

関連項目

「ParameterCollection」の関連用語


	© 2024 Microsoft.All rights reserved.

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

ParameterCollection イベント

関連項目

ParameterCollection クラス

ParameterCollection コンストラクタ

ParameterCollection プロパティ

関連項目

ParameterCollection メソッド

関連項目

ParameterCollection メンバ

関連項目

急上昇のことば

「ParameterCollection」の関連用語

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