ParameterCollection.Add Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Koleksiyona bir Parameter nesne ekler.

Aşırı Yüklemeler

Add(Parameter)

Belirtilen Parameter nesneyi koleksiyonun sonuna ekler.
Add(String, String)

Belirtilen ad ve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler.
Add(String, DbType, String)

Belirtilen ad, veritabanı türü ve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler.
Add(String, TypeCode, String)

Belirtilen ad, TypeCodeve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler.

Add(Parameter)

Belirtilen Parameter nesneyi koleksiyonun sonuna ekler.

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

Parametreler

parameter
Parameter

Parameter Koleksiyonun sonuna eklenecek olan.

Döndürülenler

Int32

Eklenen öğenin dizin değeri.

Örnekler

Aşağıdaki kod örneği, bir AccessDataSource denetimin ve bir FormParameter nesnenin microsoft access veritabanındaki bilgileri bir denetimde GridView görüntülemek için nasıl kullanılacağını gösterir. FormParameter nesnesi yöntemi kullanılarak koleksiyona SelectParametersAdd(Parameter) eklenir.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz . Betik Açıklarına Genel Bakış.

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

Açıklamalar

Add(Parameter) Bir nesneyi koleksiyonun sonuna eklemek Parameter için yöntemini kullanın. yönteminin bu uygulaması parametresi tarafından param belirtilen nesnesini alır Parameter ve koleksiyona ekler.

Ayrıca bkz.

Şunlara uygulanır

Add(String, String)

Belirtilen ad ve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler.

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

Parametreler

name
String

Parametrenin adı.

value
String

parametresi için varsayılan değer olarak hizmet veren bir dize.

Döndürülenler

Int32

Eklenen öğenin dizin değeri.

Örnekler

Aşağıdaki kod örneği, ve value parametrelerini sağlayarak bir koleksiyona yeni Parameter nesneler eklemek için ParameterCollection yönteminin name nasıl Add(String, String) kullanılabileceğini gösterir. Bu örnekte, access Parameter veri kaynağı denetiminin bir denetimin değerine bağlı update komutuna bir TextBox nesne eklenir.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz . Betik Açıklarına Genel Bakış.

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

Açıklamalar

Add(String, String) Varsayılan değere sahip bir Parameter nesne oluşturmak ve koleksiyonun sonuna eklemek için yöntemini kullanın. Yönteminin bu uygulaması, sırasıyla ve value parametreleri tarafından name belirtilen ad ve varsayılan değeri kullanarak nesnesini oluşturur Parameter ve koleksiyonuna ekler.

Ayrıca bkz.

Şunlara uygulanır

Add(String, DbType, String)

Belirtilen ad, veritabanı türü ve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler.

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

Parametreler

name
String

Parametrenin adı.

dbType
DbType

Parametresinin veritabanı türü.

value
String

parametresi için varsayılan değer.

Döndürülenler

Int32

Eklenen öğenin dizin değeri.

Açıklamalar

Bu yöntem veritabanı türleri içindir. Add(String, TypeCode, String) CLR türleri için yöntemini kullanın.

Şunlara uygulanır

Add(String, TypeCode, String)

Belirtilen ad, TypeCodeve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler.

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

Parametreler

name
String

Parametrenin adı.

type
TypeCode

Parametrenin türü.

value
String

parametresi için varsayılan değer.

Döndürülenler

Int32

Eklenen öğenin dizin değeri.

Örnekler

Aşağıdaki kod örneği, yönteminin Add(String, TypeCode, String) , valueve type parametrelerini sağlayarak namebir ParameterCollection koleksiyona yeni Parameter nesneler eklemek için nasıl kullanılabileceğini gösterir. Bu örnekte, Parameter geçerli sistem saatinin değerini sağlayan Access veri kaynağı denetiminin Update komutuna bir nesne eklenir. parametresi ile eklenir TypeCodeDateTime.

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

Açıklamalar

Koleksiyonun Add(String, TypeCode, String) sonuna varsayılan değerle kesin olarak belirlenmiş Parameter bir nesne oluşturmak ve eklemek için yöntemini kullanın. yönteminin bu uygulaması, nesnesini sırasıyla ve type parametreleri tarafından namebelirtilen ad, tür ve value değeri kullanarak oluşturur Parameter ve koleksiyona ekler.

Ayrıca bkz.

Şunlara uygulanır