QueryStringParameter クラスとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

QueryStringParameter クラス

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

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

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

Visual Basic (宣言)
Public Class QueryStringParameter
    Inherits Parameter
Visual Basic (使用法)
Dim instance As QueryStringParameter
C#
public class QueryStringParameter : Parameter
C++
public ref class QueryStringParameter : public
 Parameter
J#
public class QueryStringParameter extends Parameter
JScript
public class QueryStringParameter extends
 Parameter
解説解説

QueryStringParameter クラスを使用すると、HTTP 要求のクエリ文字列に渡されたフィールド値を、パラメータ クエリまたはコマンドで使用するためのパラメータにバインドできます。このフィールドは、QueryString コレクションから取得されます。QueryStringParameter が指定されていても、対応するクエリ文字列の名前/値ペアが渡されないと、データをパラメータにバインドするコントロールから例外がスローされます。同様に、クエリ文字列フィールドの名前だけを渡して、対応する値を渡さなかった場合、データは表示されません。このような状況を防ぐには、必要に応じて DefaultValue を設定します。

QueryStringParameter クラスには、Parameter クラスから継承されたプロパティに加え、バインド先のクエリ文字列値の名前を識別する QueryStringField プロパティが用意されています。

メモ重要 :

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

使用例使用例

QueryStringParameter パラメータを宣言してフィルタとして使用し、GridView コントロールにデータを表示する方法を次のコード例に示します。QueryStringParameter を AccessDataSource コントロールの FilterParameters コレクションに宣言および追加すると、クエリ文字列フィールド "country" の値が対応する FilterExpression 文字列にバインドされます。パラメータに対して DefaultValue が指定されていないため、"country" という名前のフィールドがクエリ文字列に渡されなかった場合、AccessDataSource から NullReferenceException がスローされます。"country" という名前のフィールドが渡された場合でも、対応する値が指定されなかった場合、GridView にデータは表示されません。

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">

<HTML>
  <body>
    <form id="Form1" method="post"
 runat="server">

      <!-- Use a Query String with country=USA
 -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of
 input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode,
 Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country"
 type="String" querystringfield="country"
 />
        </filterparameters>
      </asp:accessdatasource>

    </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">

<HTML>
  <body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country
 FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String"
 querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </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">

<HTML>
  <body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceMode="DataSet"
        DataSourceID="MyAccessDataSource" />

      <asp:AccessDataSource
        id="MyAccessDataSource"
        runat="server"
        DataFile="Northwind.mdb"
        SelectCommand="SELECT EmployeeID, LastName, Address, PostalCode, Country
 FROM Employees"
        FilterExpression="Country = '@country'">
        <FilterParameters>
          <asp:QueryStringParameter Name="country" Type="String"
 QueryStringField="country" />
        </FilterParameters>
      </asp:AccessDataSource>
    </form>
  </body>
</HTML>

QueryStringParameter を宣言し、SQL パラメータ クエリを使って、Access データベースのデータを表示する方法を次のコード例に示します。GridView コントロールに表示するレコードは、AccessDataSource によって取得されます。GridView は、ユーザーが Northwind Traders Orders テーブルのレコードを選択してボタンをクリックしたときのレコードの順序を更新するためのユーザー インターフェイスを備え、編集することもできます。

Visual Basic
<%@Page  Language="VB" %>
<%@Import Namespace="System.Data"
 %>
<%@Import Namespace="System.Data.Common"
 %>
<!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 UpdateRecords(source As
 Object, e As EventArgs)

  ' This method is an example of batch updating using a
  ' data source control. The method iterates through the rows
  ' of the GridView, extracts each CheckBox from the row and, if
  ' the CheckBox is checked, updates data by calling the Update
  ' method of the data source control, adding required parameters
  ' to the UpdateParameters collection.

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      Dim param1 As New
 Parameter("date", TypeCode.DateTime, DateTime.Now.ToString())
      MyAccessDataSource.UpdateParameters.Add(param1)

      Dim param2 As New
 Parameter("orderid", TypeCode.String, oid)
      MyAccessDataSource.UpdateParameters.Add(param2)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</SCRIPT>
<HTML>
  <BODY>
    <FORM runat="server">

<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of
 input from the client.
     Security Note: To validate the value of
 the QueryStringParameter, handle the Selecting event. -->

      <asp:SqlDataSource
        id="MyAccessDataSource"
        runat="server"
        ProviderName="<%$ ConnectionStrings:MyPasswordProtectedAccess.providerName%>"
        ConnectionString="<%$ ConnectionStrings:MyPasswordProtectedAccess%>"
        SelectCommand="SELECT OrderID, OrderDate, RequiredDate,
 ShippedDate FROM Orders WHERE EmployeeID=?"
        UpdateCommand="UPDATE Orders SET ShippedDate=? WHERE OrderID
 = ?">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId"
 QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceID="MyAccessDataSource"
        AllowPaging="True"
        PageSize="10"
        AutoGenerateColumns="False">
          <columns>
            <asp:TemplateField HeaderText="">
              <ItemTemplate>
                <asp:CheckBox runat="server" />
              </ItemTemplate>
            </asp:TemplateField>
            <asp:BoundField HeaderText="Order"
 DataField="OrderID" />
            <asp:BoundField HeaderText="Order Date"
 DataField="OrderDate" />
            <asp:BoundField HeaderText="Required Date"
 DataField="RequiredDate" />
            <asp:BoundField HeaderText="Shipped Date"
 DataField="ShippedDate" />
          </columns>
      </asp:GridView>

      <asp:Button
        id="Button1"
        runat="server"
        Text="Update the Selected Records As Shipped"
        OnClick="UpdateRecords" />

      <asp:Label id="Label1" runat="server"
 />

    </FORM>
  </BODY>
</HTML>
C#
<%@Page  Language="C#" %>
<%@Import Namespace="System.Data" %>
<%@Import Namespace="System.Data.Common" %>
<!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 UpdateRecords(Object source, EventArgs
 e)
{
  // This method is an example of batch updating using a
  // data source control. The method iterates through the rows
  // of the GridView, extracts each CheckBox from the row and, if
  // the CheckBox is checked, updates data by calling the Update
  // method of the data source control, adding required parameters
  // to the UpdateParameters collection.
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows)
 {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add(new Parameter("date"
,TypeCode.DateTime,DateTime.Now.ToString()));
      MyAccessDataSource.UpdateParameters.Add(new Parameter("orderid"
,TypeCode.String,oid));
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</SCRIPT>

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

<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the
 Selecting event. -->

      <asp:SqlDataSource
        id="MyAccessDataSource"
        runat="server"
        ProviderName="<%$ ConnectionStrings:MyPasswordProtectedAccess.providerName%>"
        ConnectionString="<%$ ConnectionStrings:MyPasswordProtectedAccess%>"
        SelectCommand="SELECT OrderID, OrderDate, RequiredDate, ShippedDate
 FROM Orders WHERE EmployeeID=?"
        UpdateCommand="UPDATE Orders SET ShippedDate=? WHERE OrderID = ?">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId"
 />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceID="MyAccessDataSource"
        AllowPaging="True"
        PageSize="10"
        AutoGenerateColumns="False">
          <columns>
            <asp:TemplateField HeaderText="">
              <ItemTemplate>
                <asp:CheckBox runat="server" />
              </ItemTemplate>
            </asp:TemplateField>
            <asp:BoundField HeaderText="Order" DataField="OrderID"
 />
            <asp:BoundField HeaderText="Order Date" DataField="OrderDate"
 />
            <asp:BoundField HeaderText="Required Date" DataField="RequiredDate"
 />
            <asp:BoundField HeaderText="Shipped Date" DataField="ShippedDate"
 />
          </columns>
      </asp:GridView>

      <asp:Button
        id="Button1"
        runat="server"
        Text="Update the Selected Records As Shipped"
        OnClick="UpdateRecords" />

      <asp:Label id="Label1" runat="server" />

    </FORM>
  </BODY>
</HTML>
J#
<%@Page  Language="VJ#" %>
<%@Import Namespace="System.Data" %>
<%@Import Namespace="System.Data.Common" %>
<!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 UpdateRecords(Object source,
 System.EventArgs e)
    {
        // This method is an example of batch updating using a
        // data source control. The method iterates through the rows
        // of the GridView, extracts each CheckBox from the row and,
 if
        // the CheckBox is checked, updates data by calling the Update
        // method of the data source control, adding required parameters
        // to the UpdateParameters collection.
        CheckBox cb;
        for (int iCtr = 0; 
                iCtr < this.GridView1.get_Rows().get_Count();
 iCtr++) {
            GridViewRow row = this.GridView1.get_Rows().get_Item(iCtr);
            cb = (CheckBox)row.get_Cells().get_Item(0).get_Controls().get_Item(1);
            if (cb.get_Checked()) {
                String oid = (String)(row.get_Cells().get_Item(1).get_Text());
                MyAccessDataSource.get_UpdateParameters().Add(new
 Parameter(
                    "date", System.TypeCode.DateTime, System.DateTime.get_Now().ToString()));
                MyAccessDataSource.get_UpdateParameters().Add(new
 Parameter(
                    "orderid", System.TypeCode.String, oid));
                MyAccessDataSource.Update();
                MyAccessDataSource.get_UpdateParameters().Clear();
            }
        }
    } //UpdateRecords
</SCRIPT>

<HTML>
  <BODY>
    <FORM runat="server">
<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the
 Selecting event. -->

      <asp:SqlDataSource
        id="MyAccessDataSource"
        runat="server"
        ProviderName="System.Data.OleDb"
        ConnectionString="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=\\uncpath\Northwind_PasswordProtected.mdb;Mode=3;Jet
 OLEDB:Database Password=myPassword;"
        SelectCommand="SELECT OrderID, OrderDate, RequiredDate, ShippedDate
 FROM Orders WHERE EmployeeID=?"
        UpdateCommand="UPDATE Orders SET ShippedDate=? WHERE OrderID = ?">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId"
 />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceID="MyAccessDataSource"
        AllowPaging="True"
        PageSize="10"
        AutoGenerateColumns="False">
          <Columns>
            <asp:TemplateField HeaderText="">
              <ItemTemplate>
                <asp:CheckBox runat="server" />
              </ItemTemplate>
            </asp:TemplateField>
            <asp:BoundField HeaderText="Order" DataField="OrderID"
 />
            <asp:BoundField HeaderText="Order Date" DataField="OrderDate"
 />
            <asp:BoundField HeaderText="Required Date" DataField="RequiredDate"
 />
            <asp:BoundField HeaderText="Shipped Date" DataField="ShippedDate"
 />
          </Columns>
      </asp:GridView>

      <asp:Button
        id="Button1"
        runat="server"
        Text="Update the Selected Records As Shipped"
        OnClick="UpdateRecords" />

      <asp:Label id="Label1" runat="server" />

    </FORM>
  </BODY>
</HTML>
継承階層継承階層
System.Object
   System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.QueryStringParameter
スレッド セーフスレッド セーフ
この型の 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
参照参照
関連項目
QueryStringParameter メンバ
System.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
FormParameter クラス
ProfileParameter クラス
SessionParameter
その他の技術情報
データ ソース コントロールとパラメータの使用

急上昇のことば

かたわ
仲を取り持つ
しきい値
懸念
示唆
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

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

Weblioのサービス

「QueryStringParameter クラス」の関連用語

1
ParameterCollection.Remove メソッド
.NET Framework クラス ライブラリ リファレンス
90% |||||

2
QueryStringParameter.Clone メソッド
.NET Framework クラス ライブラリ リファレンス
74% |||||

3
QueryStringParameter コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
72% |||||

4
ParameterCollection.RemoveAt メソッド
.NET Framework クラス ライブラリ リファレンス
72% |||||

5
ParameterCollection.Insert メソッド
.NET Framework クラス ライブラリ リファレンス
70% |||||

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

7
QueryStringParameter.QueryStringField プロパティ
.NET Framework クラス ライブラリ リファレンス
52% |||||

8
ObjectDataSourceView.SelectParameters プロパティ
.NET Framework クラス ライブラリ リファレンス
38% |||||

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

10
QueryStringParameter メンバ
.NET Framework クラス ライブラリ リファレンス
34% |||||

QueryStringParameter クラスのお隣キーワード

QueryPageSettingsEventArgs コンストラクタ

QueryPageSettingsEventArgs プロパティ

QueryPageSettingsEventArgs メソッド

QueryPageSettingsEventArgs メンバ

QueryPageSettingsEventArgs.PageSettings プロパティ

QueryPageSettingsEventHandler デリゲート

QueryStringParameter クラス

QueryStringParameter コンストラクタ

QueryStringParameter プロパティ

QueryStringParameter メソッド

QueryStringParameter メンバ

QueryStringParameter.Clone メソッド

QueryStringParameter.Evaluate メソッド

検索ランキング

   

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


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

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

©2025 GRAS Group, Inc.RSS