FormParameter.FormParameter(String, TypeCode, String) Constructor

Initializes a new named and strongly typed instance of the FormParameter class, using the specified string to identify which form variable to bind to.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public:
FormParameter (
	String^ name, 
	TypeCode type, 
	String^ formField
)
public FormParameter (
	String name, 
	TypeCode type, 
	String formField
)
public function FormParameter (
	name : String, 
	type : TypeCode, 
	formField : String
)
Not applicable.

Parameters

name

The name of the parameter.

type

The type that the parameter represents. The default is Object.

formField

The name of the form variable that the parameter object is bound to. The default is Empty.

A FormParameter object created with the FormParameter constructor is initialized with the specified parameter name, Type, and string that identifies the form variable that the parameter binds to. Only the Direction and ConvertEmptyStringToNull properties are initialized with default values.

Security noteSecurity Note:

The FormParameter does not validate the value passed by the form element in any way; it uses the raw value. In most cases, you can validate the value of the FormParameter before it is used by a data source control by handling an event, such as the Selecting, Updating, Inserting, or Deleting event exposed by the data source control you are using. If the value of the parameter does not pass your validation tests, you can cancel the data operation by setting the Cancel property of the associated CancelEventArgs class to true.

No code example is currently available or this language may not be supported.
<%@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", 
            System.TypeCode.String, "LastNameBox");
        AccessDataSource1.get_SelectParameters().Add(formParam);
    } //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>

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: