ParameterCollection.Add Methode

Definition

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

Fügt der Auflistung ein Parameter Objekt hinzu.

Überlädt

Name Beschreibung
Add(Parameter)

Fügt das angegebene Parameter Objekt an das Ende der Auflistung an.
Add(String, String)

Erstellt ein Parameter Objekt mit dem angegebenen Namen und Standardwert und fügt es an das Ende der Auflistung an.
Add(String, DbType, String)

Erstellt ein Parameter Objekt mit dem angegebenen Namen, dem Datenbanktyp und dem Standardwert und fügt es am Ende der Auflistung hinzu.
Add(String, TypeCode, String)

Erstellt ein Parameter Objekt mit dem angegebenen Namen, TypeCodedem Standardwert und fügt es an das Ende der Auflistung an.

Add(Parameter)

Fügt das angegebene Parameter Objekt an das Ende der Auflistung an.

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

Parameter

parameter
Parameter

Der Parameter an die Auflistung anzufügende Text.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Beispiele

Im folgenden Codebeispiel wird die Verwendung eines AccessDataSource-Steuerelements und eines FormParameter-Objekts zum Anzeigen von Informationen aus einer Microsoft Access Datenbank in einem GridView-Steuerelement veranschaulicht. Das FormParameter Objekt wird der Auflistung mithilfe der SelectParametersAdd(Parameter) Methode hinzugefügt.

Important

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

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

Verwenden Sie die Add(Parameter) Methode, um ein Parameter Objekt an das Ende der Auflistung anzufügen. Diese Implementierung der Methode verwendet das Parameter durch den param Parameter angegebene Objekt und fügt es an die Auflistung an.

Weitere Informationen

Gilt für:

Add(String, String)

Erstellt ein Parameter Objekt mit dem angegebenen Namen und Standardwert und fügt es an das Ende der Auflistung an.

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

Parameter

name
String

Der Name des Parameters.

value
String

Eine Zeichenfolge, die als Standardwert für den Parameter dient.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Hinweise

Verwenden Sie die Add(String, String) Methode, um ein Parameter Objekt mit einem Standardwert am Ende der Auflistung zu erstellen und anzufügen. Mit dieser Implementierung der Methode wird das Parameter Objekt unter Verwendung des Namens und des Standardwerts erstellt, der bzw. die durch die namevalue Parameter angegeben wird, und fügt es an die Auflistung an.

Weitere Informationen

Gilt für:

Add(String, DbType, String)

Erstellt ein Parameter Objekt mit dem angegebenen Namen, dem Datenbanktyp und dem Standardwert und fügt es am Ende der Auflistung hinzu.

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

Parameter

name
String

Der Name des Parameters.

dbType
DbType

Der Datenbanktyp des Parameters.

value
String

Der Standardwert für den Parameter.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Hinweise

Diese Methode ist für Datenbanktypen vorgesehen. Verwenden Sie die Add(String, TypeCode, String) Methode für CLR-Typen.

Gilt für:

Add(String, TypeCode, String)

Erstellt ein Parameter Objekt mit dem angegebenen Namen, TypeCodedem Standardwert und fügt es an das Ende der Auflistung an.

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

Parameter

name
String

Der Name des Parameters.

type
TypeCode

Der Typ des -Parameters.

value
String

Der Standardwert für den Parameter.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Hinweise

Verwenden Sie die Add(String, TypeCode, String) Methode, um ein stark typiertes Parameter Objekt mit einem Standardwert am Ende der Auflistung zu erstellen und anzufügen. Diese Implementierung der Methode erstellt das Parameter Objekt unter Verwendung des Namens, des Typs und des Werts, der durch die nametype Parameter bzwvalue. parameter angegeben wird, und fügt es an die Auflistung an.

Weitere Informationen

Gilt für: