ParameterCollection.Add Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 SelectParameters Add(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

<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.

Parameter

Ş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 TypeCode DateTime.

<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.

Parameter

Şunlara uygulanır

Aracılığıyla paylaş

ParameterCollection.Add Yöntem

Tanım

Aşırı Yüklemeler

Add(Parameter)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, DbType, String)

Parametreler

Döndürülenler

Açıklamalar

Şunlara uygulanır

Add(String, TypeCode, String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar