ParameterCollection.Add Methode

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee voegt u een Parameter object toe aan de verzameling.

Overloads

Name	Description
Add(Parameter)	Voegt het opgegeven Parameter object toe aan het einde van de verzameling.
Add(String, String)	Hiermee maakt u een Parameter object met de opgegeven naam en standaardwaarde en voegt u het toe aan het einde van de verzameling.
Add(String, DbType, String)	Hiermee maakt u een Parameter object met de opgegeven naam, het databasetype en de standaardwaarde en voegt u het toe aan het einde van de verzameling.
Add(String, TypeCode, String)	Hiermee maakt u een Parameter object met de opgegeven naam TypeCodeen de standaardwaarde en voegt u het toe aan het einde van de verzameling.

Add(Parameter)

Voegt het opgegeven Parameter object toe aan het einde van de verzameling.

public:
 int Add(System::Web::UI::WebControls::Parameter ^ parameter);

public int Add(System.Web.UI.WebControls.Parameter parameter);

member this.Add : System.Web.UI.WebControls.Parameter -> int

Public Function Add (parameter As Parameter) As Integer

Parameters

parameter: Parameter

De Parameter toe te voegen aan de verzameling.

Retouren

Int32

De indexwaarde van het toegevoegde item.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een besturingselement AccessDataSource en een FormParameter-object gebruikt om informatie uit een Microsoft Access database weer te geven in een besturingselement GridView. Het FormParameter object wordt aan de SelectParameters verzameling toegevoegd met behulp van de Add(Parameter) methode.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

Opmerkingen

Gebruik de Add(Parameter) methode om een Parameter object toe te voegen aan het einde van de verzameling. Deze implementatie van de methode neemt het Parameter object dat is opgegeven door de param parameter en voegt het toe aan de verzameling.

Zie ook

Van toepassing op

Add(String, String)

Hiermee maakt u een Parameter object met de opgegeven naam en standaardwaarde en voegt u het toe aan het einde van de verzameling.

public:
 int Add(System::String ^ name, System::String ^ value);

public int Add(string name, string value);

member this.Add : string * string -> int

Public Function Add (name As String, value As String) As Integer

Parameters

name: String

De naam van de parameter.

value: String

Een tekenreeks die fungeert als een standaardwaarde voor de parameter.

Retouren

Int32

De indexwaarde van het toegevoegde item.

Opmerkingen

Gebruik de Add(String, String) methode om een Parameter object te maken en toe te voegen met een standaardwaarde aan het einde van de verzameling. Met deze implementatie van de methode wordt het Parameter object gemaakt met de naam en de standaardwaarde die is opgegeven door respectievelijk de name en value parameters, en wordt het aan de verzameling toegevoegd.

Zie ook

Parameter

Van toepassing op

Add(String, DbType, String)

Hiermee maakt u een Parameter object met de opgegeven naam, het databasetype en de standaardwaarde en voegt u het toe aan het einde van de verzameling.

public:
 int Add(System::String ^ name, System::Data::DbType dbType, System::String ^ value);

public int Add(string name, System.Data.DbType dbType, string value);

member this.Add : string * System.Data.DbType * string -> int

Public Function Add (name As String, dbType As DbType, value As String) As Integer

Parameters

name: String

De naam van de parameter.

dbType: DbType

Het databasetype van de parameter.

value: String

De standaardwaarde voor de parameter.

Retouren

Int32

De indexwaarde van het toegevoegde item.

Opmerkingen

Deze methode is bedoeld voor databasetypen. Gebruik de Add(String, TypeCode, String) methode voor CLR-typen.

Van toepassing op

Add(String, TypeCode, String)

Hiermee maakt u een Parameter object met de opgegeven naam TypeCodeen de standaardwaarde en voegt u het toe aan het einde van de verzameling.

public:
 int Add(System::String ^ name, TypeCode type, System::String ^ value);

public int Add(string name, TypeCode type, string value);

member this.Add : string * TypeCode * string -> int

Public Function Add (name As String, type As TypeCode, value As String) As Integer

Parameters

name: String

De naam van de parameter.

type: TypeCode

Het type van de parameter.

value: String

De standaardwaarde voor de parameter.

Retouren

Int32

De indexwaarde van het toegevoegde item.

Opmerkingen

Gebruik de Add(String, TypeCode, String) methode om een sterk getypt Parameter object te maken en toe te voegen met een standaardwaarde aan het einde van de verzameling. Met deze implementatie van de methode wordt het Parameter object gemaakt met behulp van de naam, het type en de waarde die is opgegeven door respectievelijk de nametype parameters, en value wordt het aan de verzameling toegevoegd.

Zie ook

Parameter

Van toepassing op

Feedback

Is deze pagina nuttig?