ParameterCollection.Add Metoda

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Parameter Přidá objekt do kolekce.

Přetížení

Name	Description
Add(Parameter)	Připojí zadaný Parameter objekt na konec kolekce.
Add(String, String)	Parameter Vytvoří objekt se zadaným názvem a výchozí hodnotou a připojí ho na konec kolekce.
Add(String, DbType, String)	Parameter Vytvoří objekt se zadaným názvem, typem databáze a výchozí hodnotou a přidá ho na konec kolekce.
Add(String, TypeCode, String)	Parameter Vytvoří objekt se zadaným názvem TypeCodea výchozí hodnotou a připojí ho na konec kolekce.

Add(Parameter)

Připojí zadaný Parameter objekt na konec kolekce.

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

Parametry

parameter: Parameter

Připojení Parameter k kolekci

Návraty

Int32

Hodnota indexu přidané položky.

Příklady

Následující příklad kódu ukazuje, jak použít ovládací prvek AccessDataSource a objekt FormParameter k zobrazení informací z databáze Microsoft Access v ovládacím prvku GridView. Objekt FormParameter je přidán do SelectParameters kolekce pomocí Add(Parameter) metody.

Important

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.

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

Poznámky

Použijte metodu Add(Parameter)Parameter k připojení objektu na konec kolekce. Tato implementace metody přebírá Parameter objekt určený parametrem param a připojí ho k kolekci.

Viz také

Platí pro

Add(String, String)

Parameter Vytvoří objekt se zadaným názvem a výchozí hodnotou a připojí ho na konec kolekce.

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

Parametry

name: String

Název parametru

value: String

Řetězec, který slouží jako výchozí hodnota parametru.

Návraty

Int32

Hodnota indexu přidané položky.

Poznámky

Použijte metodu Add(String, String) k vytvoření a připojení objektu Parameter s výchozí hodnotou na konec kolekce. Tato implementace metody vytvoří Parameter objekt pomocí názvu a výchozí hodnoty určené parametry name a value připojí jej k kolekci.

Viz také

Parameter

Platí pro

Add(String, DbType, String)

Parameter Vytvoří objekt se zadaným názvem, typem databáze a výchozí hodnotou a přidá ho na konec kolekce.

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

Parametry

name: String

Název parametru

dbType: DbType

Typ databáze parametru.

value: String

Výchozí hodnota parametru.

Návraty

Int32

Hodnota indexu přidané položky.

Poznámky

Tato metoda je určená pro typy databází. Použijte metodu Add(String, TypeCode, String) pro typy CLR.

Platí pro

Add(String, TypeCode, String)

Parameter Vytvoří objekt se zadaným názvem TypeCodea výchozí hodnotou a připojí ho na konec kolekce.

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

Parametry

name: String

Název parametru

type: TypeCode

Typ parametru

value: String

Výchozí hodnota parametru.

Návraty

Int32

Hodnota indexu přidané položky.

Poznámky

Použijte metodu Add(String, TypeCode, String) k vytvoření a připojení objektu silného typu Parameter s výchozí hodnotou na konec kolekce. Tato implementace metody vytvoří Parameter objekt pomocí názvu, typu a hodnoty určené parametrem name, typevalue v uvedeném pořadí, a připojí jej do kolekce.

Viz také

Parameter

Platí pro

Váš názor

Byla tato stránka užitečná?