FormParameter Konstruktoren

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Initialisiert eine neue Instanz der FormParameter-Klasse.

Überlädt

FormParameter()

Initialisiert eine neue unbenannte Instanz der FormParameter-Klasse.
FormParameter(FormParameter)

Initialisiert eine neue Instanz der FormParameter-Klasse mit den Werten der Instanz, die vom original-Parameter angegeben wird.
FormParameter(String, String)

Initialisiert eine neue benannte Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Formularvariablenfeld zu identifizieren, an das die Bindung erfolgen soll.
FormParameter(String, DbType, String)

Initialisiert eine neue Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Formularvariablenfeld zu identifizieren, an das die Bindung erfolgen soll.
FormParameter(String, TypeCode, String)

Initialisiert eine neue benannte und stark typisierte Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um die Formularvariable zu identifizieren, an die die Bindung erfolgen soll.

FormParameter()

Initialisiert eine neue unbenannte Instanz der FormParameter-Klasse.

public:
 FormParameter();
public FormParameter ();
Public Sub New ()

Beispiele

Wichtig

Der FormParameter überprüft den vom Formularelement übergebenen Wert in keiner Weise. Es verwendet den Rohwert. In den meisten Fällen können Sie den Wert von FormParameter überprüfen, bevor er von einem Datenquellensteuerelement verwendet wird, indem Sie ein Ereignis behandeln, z. B. das Selecting- , Updating- Insertingoder Deleting -Ereignis, das vom verwendeten Datenquellensteuerelement verfügbar gemacht wird. Wenn der Wert des Parameters die Validierungstests nicht besteht, können Sie den Datenvorgang abbrechen, indem Sie die Cancel -Eigenschaft der zugeordneten CancelEventArgs Klasse auf truefestlegen.

<%@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();
  formParam.Name="lastname";
  formParam.Type=TypeCode.String;
  formParam.FormField="LastNameBox";
  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" />

    </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()
  formParam.Name="lastname"
  formParam.Type=TypeCode.String
  formParam.FormField="LastNameBox"
  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" />

    </form>
  </body>
</html>

Hinweise

Ein FormParameter mit dem FormParameter Konstruktor erstelltes Objekt wird mit Standardwerten für alle zugehörigen Eigenschaften initialisiert. Der FormField wird mit String.Emptyinitialisiert. Darüber hinaus wird die Name -Eigenschaft mit String.Emptyinitialisiert, die Type -Eigenschaft wird mit TypeCode.Objectinitialisiert, die Direction -Eigenschaft wird mit Inputinitialisiert, und die DefaultValue -Eigenschaft wird mit NULL initialisiert (Nothing in Visual Basic).

Weitere Informationen

Gilt für:

FormParameter(FormParameter)

Initialisiert eine neue Instanz der FormParameter-Klasse mit den Werten der Instanz, die vom original-Parameter angegeben wird.

protected:
 FormParameter(System::Web::UI::WebControls::FormParameter ^ original);
protected FormParameter (System.Web.UI.WebControls.FormParameter original);
new System.Web.UI.WebControls.FormParameter : System.Web.UI.WebControls.FormParameter -> System.Web.UI.WebControls.FormParameter
Protected Sub New (original As FormParameter)

Parameter

original
FormParameter

Eine FormParameter-Instanz, von der die aktuelle Instanz initialisiert wird.

Hinweise

Der FormParameter Konstruktor ist ein protected Kopierkonstruktor, der zum Klonen einer FormParameter instance verwendet wird. Die Werte von FormParameter, einschließlich FormField, Nameund Type werden alle an die neue instance übertragen.

Weitere Informationen

Gilt für:

FormParameter(String, String)

Initialisiert eine neue benannte Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Formularvariablenfeld zu identifizieren, an das die Bindung erfolgen soll.

public:
 FormParameter(System::String ^ name, System::String ^ formField);
public FormParameter (string name, string formField);
new System.Web.UI.WebControls.FormParameter : string * string -> System.Web.UI.WebControls.FormParameter
Public Sub New (name As String, formField As String)

Parameter

name
String

Der Name des Parameters.

formField
String

Der Name der Formularvariablen, an die das Parameterobjekt gebunden ist. Der Standardwert ist Empty.

Beispiele

Wichtig

Der FormParameter überprüft den vom Formularelement übergebenen Wert in keiner Weise. Es verwendet den Rohwert. In den meisten Fällen können Sie den Wert von FormParameter überprüfen, bevor er von einem Datenquellensteuerelement verwendet wird, indem Sie ein Ereignis behandeln, z. B. das Selecting- , Updating- Insertingoder Deleting -Ereignis, das vom verwendeten Datenquellensteuerelement verfügbar gemacht wird. Wenn der Wert des Parameters die Validierungstests nicht besteht, können Sie den Datenvorgang abbrechen, indem Sie die Cancel -Eigenschaft der zugeordneten CancelEventArgs Klasse auf truefestlegen.

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

Hinweise

Ein FormParameter mit dem FormParameter Konstruktor erstelltes Objekt wird mit dem angegebenen Parameternamen und der angegebenen Zeichenfolge initialisiert, die die Formularvariable identifiziert, an die der Parameter gebunden ist. Die Type Eigenschaften und Direction werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

FormParameter(String, DbType, String)

Initialisiert eine neue Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Formularvariablenfeld zu identifizieren, an das die Bindung erfolgen soll.

public:
 FormParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ formField);
public FormParameter (string name, System.Data.DbType dbType, string formField);
new System.Web.UI.WebControls.FormParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.FormParameter
Public Sub New (name As String, dbType As DbType, formField As String)

Parameter

name
String

Der Name des Parameters.

dbType
DbType

Der Datenbanktyp des Parameters.

formField
String

Der Name der Formularvariablen, an die das Parameterobjekt gebunden ist.

Gilt für:

FormParameter(String, TypeCode, String)

Initialisiert eine neue benannte und stark typisierte Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um die Formularvariable zu identifizieren, an die die Bindung erfolgen soll.

public:
 FormParameter(System::String ^ name, TypeCode type, System::String ^ formField);
public FormParameter (string name, TypeCode type, string formField);
new System.Web.UI.WebControls.FormParameter : string * TypeCode * string -> System.Web.UI.WebControls.FormParameter
Public Sub New (name As String, type As TypeCode, formField As String)

Parameter

name
String

Der Name des Parameters.

type
TypeCode

Der Typ, den der Parameter darstellt. Der Standardwert ist Object.

formField
String

Der Name der Formularvariablen, an die das Parameterobjekt gebunden ist. Der Standardwert ist Empty.

Beispiele

Wichtig

Der FormParameter überprüft den vom Formularelement übergebenen Wert in keiner Weise. Es verwendet den Rohwert. In den meisten Fällen können Sie den Wert von FormParameter überprüfen, bevor er von einem Datenquellensteuerelement verwendet wird, indem Sie ein Ereignis behandeln, z. B. das Selecting- , Updating- Insertingoder Deleting -Ereignis, das vom verwendeten Datenquellensteuerelement verfügbar gemacht wird. Wenn der Wert des Parameters die Validierungstests nicht besteht, können Sie den Datenvorgang abbrechen, indem Sie die Cancel -Eigenschaft der zugeordneten CancelEventArgs Klasse auf truefestlegen.

<%@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", TypeCode.String, "LastNameBox");
  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",TypeCode.String,"LastNameBox")
  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>

Hinweise

Ein FormParameter mit dem FormParameter Konstruktor erstelltes Objekt wird mit dem angegebenen Parameternamen und der angegebenen Zeichenfolge initialisiert, Typedie die Formularvariable identifiziert, an die der Parameter gebunden ist. Nur die Direction Eigenschaften und ConvertEmptyStringToNull werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für: