ParameterCollection.Add Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Parameter Dodaje obiekt do kolekcji.
Przeciążenia
| Nazwa | Opis |
|---|---|
| Add(Parameter) |
Dołącza określony Parameter obiekt na końcu kolekcji. |
| Add(String, String) |
Parameter Tworzy obiekt o określonej nazwie i wartości domyślnej i dołącza go na końcu kolekcji. |
| Add(String, DbType, String) |
Parameter Tworzy obiekt o określonej nazwie, typie bazy danych i wartości domyślnej i dodaje go na końcu kolekcji. |
| Add(String, TypeCode, String) |
Parameter Tworzy obiekt o określonej nazwie, TypeCodei wartości domyślnej i dołącza go na końcu kolekcji. |
Add(Parameter)
Dołącza określony Parameter obiekt na końcu kolekcji.
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
Zwraca
Wartość indeksu dodanego elementu.
Przykłady
W poniższym przykładzie kodu pokazano, jak używać kontrolki AccessDataSource i obiektu FormParameter do wyświetlania informacji z bazy danych Microsoft Access w kontrolce GridView. Obiekt FormParameter jest dodawany do kolekcji SelectParameters przy użyciu Add(Parameter) metody .
Ważna
W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptu ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).
<%@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>
Uwagi
Add(Parameter) Użyj metody , aby dołączyć Parameter obiekt na końcu kolekcji. Ta implementacja metody pobiera Parameter obiekt określony przez param parametr i dołącza go do kolekcji.
Zobacz też
Dotyczy
Add(String, String)
Parameter Tworzy obiekt o określonej nazwie i wartości domyślnej i dołącza go na końcu kolekcji.
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
Nazwa parametru.
- value
- String
Ciąg, który służy jako wartość domyślna parametru.
Zwraca
Wartość indeksu dodanego elementu.
Uwagi
Add(String, String) Użyj metody , aby utworzyć i dołączyć Parameter obiekt z wartością domyślną na końcu kolekcji. Ta implementacja metody tworzy Parameter obiekt przy użyciu nazwy i wartości domyślnej name określonej odpowiednio przez parametry i value i i dołącza go do kolekcji.
Zobacz też
Dotyczy
Add(String, DbType, String)
Parameter Tworzy obiekt o określonej nazwie, typie bazy danych i wartości domyślnej i dodaje go na końcu kolekcji.
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
Nazwa parametru.
- dbType
- DbType
Typ bazy danych parametru.
- value
- String
Wartość domyślna parametru.
Zwraca
Wartość indeksu dodanego elementu.
Uwagi
Ta metoda dotyczy typów baz danych. Add(String, TypeCode, String) Użyj metody dla typów CLR.
Dotyczy
Add(String, TypeCode, String)
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
Nazwa parametru.
- type
- TypeCode
Typ parametru.
- value
- String
Wartość domyślna parametru.
Zwraca
Wartość indeksu dodanego elementu.
Uwagi
Add(String, TypeCode, String) Użyj metody , aby utworzyć i dołączyć silnie typowany Parameter obiekt z wartością domyślną na końcu kolekcji. Ta implementacja metody tworzy Parameter obiekt przy użyciu nazwy, typu i wartości określonej odpowiednio przez nametype parametry i i value dołącza go do kolekcji.