QueryStringParameter 类

来源：互联网发布：java 角色权限设计编辑：程序博客网时间：2024/05/12 09:44

将 HTTP 请求查询字符串字段的值绑定到参数对象。

继承层次结构

System..::.Object
System.Web.UI.WebControls..::.Parameter
System.Web.UI.WebControls..::.QueryStringParameter

命名空间： System.Web.UI.WebControls

程序集： System.Web（在 System.Web.dll 中）

public class QueryStringParameter : Parameter

QueryStringParameter 类型公开以下成员。

构造函数

名称说明

QueryStringParameter()()()初始化 QueryStringParameter 类的未命名新实例。受保护的方法

QueryStringParameter(QueryStringParameter)使用 original 参数指定的实例的值初始化 QueryStringParameter 类的新实例。公共方法

QueryStringParameter(String, String)使用指定的字符串来标识要绑定到的查询字符串字段，初始化QueryStringParameter 类的新命名实例。公共方法

QueryStringParameter(String, DbType, String)使用指定的查询字符串字段和参数的数据类型，初始化QueryStringParameter 类的新命名实例。公共方法

QueryStringParameter(String, TypeCode, String)使用指定的字符串来标识要绑定到的查询字符串字段，初始化QueryStringParameter 类的新强类型命名实例。页首

属性

名称说明

ConvertEmptyStringToNull获取或设置一个值，该值指示在Parameter 对象绑定到的值为String..::.Empty 时是否应将其转换为 nullNothingnullptrnull 引用（在 Visual Basic 中为Nothing）。（继承自 Parameter。）公共属性

DbType获取或设置参数的数据库类型。（继承自Parameter。）公共属性

DefaultValue指定参数的默认值（如果调用Evaluate 方法时参数绑定到的值未被初始化）。（继承自Parameter。）公共属性

Direction指示 Parameter 对象是否用于将值绑定到控件，或者是否可以使用控件更改值。（继承自Parameter。）受保护的属性

IsTrackingViewState获取一个值，该值指示Parameter 对象是否正保存对其视图状态的更改。（继承自Parameter。）公共属性

Name获取或设置参数的名称。（继承自Parameter。）公共属性

QueryStringField获取或设置参数所绑定的查询字符串字段的名称。公共属性

Size获取或设置参数的大小。（继承自Parameter。）公共属性

Type获取或设置参数类型。（继承自Parameter。）受保护的属性

ViewState获取状态信息的字典，这些信息使您可以在同一页面的多个请求间保存和恢复Parameter 对象的视图状态。（继承自Parameter。）页首

方法

名称说明

Clone返回当前 QueryStringParameter 实例的副本。（重写Parameter..::.Clone()()()。）公共方法

Equals(Object)确定指定的Object 是否等于当前的Object。（继承自Object。）受保护的方法

Evaluate更新并返回QueryStringParameter 对象的值。（重写Parameter..::.Evaluate(HttpContext, Control)。）受保护的方法

Finalize允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自Object。）公共方法

GetDatabaseType获取与当前Parameter 实例的 CLR 类型等效的DbType 值。（继承自Parameter。）公共方法

GetHashCode用作特定类型的哈希函数。（继承自Object。）公共方法

GetType获取当前实例的Type。（继承自Object。）受保护的方法

LoadViewState将数据源视图还原为保存过的前一视图状态。（继承自Parameter。）受保护的方法

MemberwiseClone创建当前 Object 的浅表副本。（继承自Object。）受保护的方法

OnParameterChanged调用包含 Parameter 对象的ParameterCollection 集合的OnParametersChanged 方法。（继承自Parameter。）受保护的方法

SaveViewState在该页被回发到服务器后保存对Parameter 对象视图状态的更改。（继承自Parameter。）受保护的方法

SetDirty标记 Parameter 对象，以便在视图状态中记录其状态。（继承自Parameter。）公共方法

ToString将此实例的值转换为其等效的字符串表示形式。（继承自Parameter。）受保护的方法

TrackViewState使 Parameter 对象跟踪其视图状态更改，以便这些更改可以存储在控件的ViewState 对象中并在同一页面的不同请求间保留。（继承自Parameter。）

备注

使用 QueryStringParameter 类可以将作为 HTTP 请求查询字符串的一部分传递的字段的值绑定到在参数化查询或命令中使用的参数。将从 QueryString 集合中检索该字段。

如果引用 QueryStringParameter 对象，但未传递任何对应的查询字符串名称/值对，则将数据绑定到参数的控件可能会引发异常。同样，如果传递查询字符串字段名称而没有对应的值，则控件可能不会显示数据。为避免出现这类情况，请在适当的位置设置DefaultValue 属性。

QueryStringParameter 类提供QueryStringField 属性，该属性标识要绑定到的查询字符串值的名称。它还提供从 Parameter 类继承的属性。

重要事项

QueryStringParameter 类不验证传递的值，它提供原始值。不过，在数据源控件中可以验证 QueryStringParameter 对象的值。为此，应处理数据源控件的 Selecting、Updating、Inserting 或Deleting 事件并检查事件处理程序中的参数值。如果参数值未通过验证测试，则可以通过将关联的 CancelEventArgs 类的Cancel 属性设置为true 来取消数据操作。

实例：

<%@ Page language="C#"%><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html  >  <head runat="server">    <title>ASP.NET Example</title></head><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>