ParameterCollection Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Az adatforrás-vezérlők által speciális adatkötési forgatókönyvekben használt és Parameterszármaztatott objektumok gyűjteményét Parameter jelöli.

public ref class ParameterCollection : System::Web::UI::StateManagedCollection

public class ParameterCollection : System.Web.UI.StateManagedCollection

type ParameterCollection = class
    inherit StateManagedCollection

Public Class ParameterCollection
Inherits StateManagedCollection

Öröklődés: Object

StateManagedCollection
ParameterCollection

Példák

Az alábbi példakód bemutatja, hogyan használható egy AccessDataSource vezérlőelem és egy FormParameter egy Microsoft Access-adatbázis adatainak megjelenítésére egy GridView vezérlőelemben. Az FormParameter objektum a metódussal lesz hozzáadva a SelectParameters gyűjteményhez Add .

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

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

Megjegyzések

Az ParameterCollection osztály az adatforrás-vezérlőkkel rendelkező speciális adatkötési forgatókönyvekben használt objektumok gyűjteményét Parameter jelöli. Az Parameter objektumok a helyi Page változók, HTTP-cookie-k, munkamenet-változók és egyéb vezérlők értékeinek adatforrás-vezérlőkhöz való kötésére szolgálnak az adatok beolvasása, frissítése, törlése és beszúrása során.

Az osztály használatával ParameterCollection programozott módon kezelheti az objektumok egy készletét Parameter . Az osztály megfelelő módszereivel Parameter hozzáadhat, beszúrhat és eltávolíthat ParameterCollection objektumokat. Ha programozott módon szeretne objektumokat lekérni Parameter egy gyűjteményből, használja az alábbi módszerek egyikét:

Az indexelővel egyetlen Parameter objektumot kérhet le a gyűjteményből név vagy tömb jelölés használatával.
Ezzel a GetEnumerator módszerrel létrehozhat egy System.Collections.IEnumerator-implementált objektumot, amely aztán a gyűjtemény elemeinek lekérésére használható.

A Count tulajdonság a gyűjtemény elemeinek teljes számát határozza meg, és a gyűjtemény felső határának meghatározására szolgál. A gyűjtemény elemeit a , Add, Insertés metódusok használatával Removeveheti fel és RemoveAt távolíthatja el.

Egy adott adatforrás-vezérlő implementációjától és szemantikától függően fontos lehet, hogy a paraméterek milyen sorrendben legyenek tárolva a ParameterCollection gyűjteményben. Ha például a SqlDataSource vezérlőt ODBC-adatforrásként használja, a gyűjtemény objektumainak Parameter sorrendjének ParameterCollection meg kell egyeznie a használt paraméteres SQL-lekérdezések paramétereinek sorrendjével. Ha azonban a SqlDataSource vezérlőelemet Microsoft SQL Server használja, a Parameter objektumok sorrendje nem fontos.

Important

Adatforrás-vezérlők használata esetén az értékek ellenőrzés nélkül kerülnek be a parancsparaméterekbe, ami potenciális biztonsági fenyegetés. Az adatforrás-vezérlőben egy esemény használatával érvényesítheti a paraméterértékeket a parancs végrehajtása előtt. További információ: Szkript kihasználása – áttekintés.

Az alábbi táblázat a különböző paraméterosztályokat és azok használatát sorolja fel.

Paraméterosztály	Leírás
Parameter	Az alapparaméter-osztály. Segítségével helyi változóhoz vagy bármely statikus sztringhez kötheti a DefaultValue tulajdonságot.
ControlParameter	Olyan paraméter, amely egy vezérlő tulajdonságához vagy metódusának visszatérési értékéhez való kötéshez használható.
CookieParameter	A cookie értékéhez kötésre használható paraméter.
FormParameter	Egy paraméter, amely az aktuális weblap attribútumához való kötéshez használható.
QueryStringParameter	Egy paraméter, amely egy lekérdezési sztring egy weblapjára átadott értékhez való kötésre használható.
SessionParameter	A munkamenet-változó értékéhez kötésre használható paraméter.
ProfileParameter	Olyan paraméter, amely egy ASP.NET Profil tulajdonság értékéhez való kötéshez használható.

Konstruktorok

Név	Description
ParameterCollection()	Inicializálja az osztályt egy örökölt osztálypéldány általi használatra. Ezt a konstruktort csak örökölt osztály hívhatja meg.

Tulajdonságok

Név	Description
Count	Lekéri a gyűjteményben StateManagedCollection található elemek számát. (Öröklődés forrása StateManagedCollection)
Item[Int32]	Lekéri vagy beállítja az Parameter objektumot a gyűjtemény megadott indexén.
Item[String]	Lekéri vagy beállítja az Parameter objektumot a gyűjteményben megadott névvel.

Metódusok

Név	Description
Add(Parameter)	Hozzáfűzi a megadott Parameter objektumot a gyűjtemény végéhez.
Add(String, DbType, String)	Létrehoz egy Parameter objektumot a megadott névvel, adatbázistípussal és alapértelmezett értékkel, és hozzáadja a gyűjtemény végéhez.
Add(String, String)	Létrehoz egy Parameter objektumot a megadott névvel és alapértelmezett értékkel, és hozzáfűzi a gyűjtemény végéhez.
Add(String, TypeCode, String)	Létrehoz egy Parameter objektumot a megadott névvel TypeCodeés alapértelmezett értékkel, és hozzáfűzi a gyűjtemény végéhez.
Clear()	Eltávolítja az összes elemet a StateManagedCollection gyűjteményből. (Öröklődés forrása StateManagedCollection)
Contains(Parameter)	Meghatározza, hogy a ParameterCollection gyűjtemény tartalmaz-e egy adott értéket.
CopyTo(Array, Int32)	A gyűjtemény elemeit StateManagedCollection egy tömbbe másolja egy adott tömbindextől kezdve. (Öröklődés forrása StateManagedCollection)
CopyTo(Parameter[], Int32)	Egy paramétertömb megadott indexét másolja a paramétergyűjteménybe.
CreateKnownType(Int32)	Létrehoz egy alapértelmezett Parameter objektumpéldányt.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetEnumerator()	Egy iterátort ad vissza, amely a StateManagedCollection gyűjteményen keresztül iterál. (Öröklődés forrása StateManagedCollection)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetKnownTypes()	Lekéri a Parameter gyűjtemény által tartalmazható típusokat ParameterCollection tartalmazó tömböt.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValues(HttpContext, Control)	Beolvas egy rendezett gyűjteményt az objektumnevekből Parameter és azok megfelelő értékeiből, amelyeket jelenleg a gyűjtemény tartalmaz.
IndexOf(Parameter)	Meghatározza egy adott Parameter objektum indexét a ParameterCollection gyűjteményben.
Insert(Int32, Parameter)	Beszúrja a megadott Parameter objektumot a ParameterCollection megadott index gyűjteményébe.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnClear()	Ha egy származtatott osztályban felül van bírálva, további munkát végez, mielőtt a metódus eltávolítja az Clear() összes elemet a gyűjteményből. (Öröklődés forrása StateManagedCollection)
OnClearComplete()	További egyéni folyamatokat hajt végre a gyűjtemény tartalmának törlése után.
OnInsert(Int32, Object)	A metódus meghívása Insert(Int32, Parameter) előtt következik be.
OnInsertComplete(Int32, Object)	A metódus befejeződése Insert(Int32, Parameter) után következik be.
OnParametersChanged(EventArgs)	Az eseményt emeli ParametersChanged ki.
OnRemove(Int32, Object)	Ha egy származtatott osztályban felül van bírálva, további munkát végez, mielőtt a IList.Remove(Object) metódus IList.RemoveAt(Int32) eltávolítja a megadott elemet a gyűjteményből. (Öröklődés forrása StateManagedCollection)
OnRemoveComplete(Int32, Object)	A metódus befejeződése Remove(Parameter) után következik be.
OnValidate(Object)	További egyéni folyamatokat hajt végre egy érték ellenőrzésekor.
Remove(Parameter)	Eltávolítja a megadott Parameter objektumot a ParameterCollection gyűjteményből.
RemoveAt(Int32)	Eltávolítja a Parameter megadott index objektumát a ParameterCollection gyűjteményből.
SetDirty()	A teljes StateManagedCollection gyűjteményt szerializálni kell megtekintési állapotba. (Öröklődés forrása StateManagedCollection)
SetDirtyObject(Object)	A megadott Parameter objektumot úgy jelöli meg, mintha az utolsó betöltés óta módosult volna, vagy mentést végzett a nézet állapotából.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
UpdateValues(HttpContext, Control)	Végigvezeti a Parameter gyűjteményben található objektumokat, és mindegyiken meghívja a `Evaluate` metódust.

esemény

Név	Description
ParametersChanged	Akkor fordul elő, ha a gyűjtemény egy vagy több Parameter objektuma megváltozik.

Explicit interfész-implementációk

Név	Description
ICollection.Count	Lekéri a gyűjteményben StateManagedCollection található elemek számát. (Öröklődés forrása StateManagedCollection)
ICollection.IsSynchronized	Beolvas egy értéket, amely jelzi, hogy a StateManagedCollection gyűjtemény szinkronizálva van-e (a szál biztonságos). Ez a módszer minden esetben visszaad `false` . (Öröklődés forrása StateManagedCollection)
ICollection.SyncRoot	Lekéri a gyűjteményhez StateManagedCollection való hozzáférés szinkronizálására használható objektumot. Ez a módszer minden esetben visszaad `null` . (Öröklődés forrása StateManagedCollection)
IEnumerable.GetEnumerator()	Egy iterátort ad vissza, amely a StateManagedCollection gyűjteményen keresztül iterál. (Öröklődés forrása StateManagedCollection)
IList.Add(Object)	Hozzáad egy elemet a StateManagedCollection gyűjteményhez. (Öröklődés forrása StateManagedCollection)
IList.Clear()	Eltávolítja az összes elemet a StateManagedCollection gyűjteményből. (Öröklődés forrása StateManagedCollection)
IList.Contains(Object)	Meghatározza, hogy a StateManagedCollection gyűjtemény tartalmaz-e egy adott értéket. (Öröklődés forrása StateManagedCollection)
IList.IndexOf(Object)	Meghatározza egy adott elem indexét a StateManagedCollection gyűjteményben. (Öröklődés forrása StateManagedCollection)
IList.Insert(Int32, Object)	Beszúr egy elemet a StateManagedCollection gyűjteménybe a megadott indexen. (Öröklődés forrása StateManagedCollection)
IList.IsFixedSize	Beolvas egy értéket, amely jelzi, hogy a StateManagedCollection gyűjtemény rögzített méretű-e. Ez a módszer minden esetben visszaad `false` . (Öröklődés forrása StateManagedCollection)
IList.IsReadOnly	Beolvas egy értéket, amely jelzi, hogy a StateManagedCollection gyűjtemény írásvédett-e. (Öröklődés forrása StateManagedCollection)
IList.Item[Int32]	Lekéri az IStateManager elemet a megadott indexhez. (Öröklődés forrása StateManagedCollection)
IList.Remove(Object)	Eltávolítja a megadott objektum első előfordulását a StateManagedCollection gyűjteményből. (Öröklődés forrása StateManagedCollection)
IList.RemoveAt(Int32)	Eltávolítja az IStateManager elemet a megadott indexből. (Öröklődés forrása StateManagedCollection)
IStateManager.IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy a StateManagedCollection gyűjtemény menti-e a nézetállapot módosításait. (Öröklődés forrása StateManagedCollection)
IStateManager.LoadViewState(Object)	Visszaállítja a gyűjtemény korábban mentett nézetállapotát StateManagedCollection és a IStateManager benne lévő elemeket. (Öröklődés forrása StateManagedCollection)
IStateManager.SaveViewState()	Menti a StateManagedCollection gyűjtemény módosításait és az általa tartalmazott objektumokat IStateManager a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása StateManagedCollection)
IStateManager.TrackViewState()	StateManagedCollection A gyűjtemény és az IStateManager összes benne lévő objektum nyomon követi a nézetállapot változásait, hogy az ugyanazon lapra vonatkozó kérések között is megmaradhassanak. (Öröklődés forrása StateManagedCollection)

Bővítő metódusok

Név	Description
AsParallel(IEnumerable)	Lehetővé teszi a lekérdezés párhuzamosítását.
AsQueryable(IEnumerable)	Átalakítja az egyiket IEnumerable IQueryable.
Cast<TResult>(IEnumerable)	Egy elem elemeit IEnumerable a megadott típusra veti.
OfType<TResult>(IEnumerable)	Egy adott típus alapján szűri IEnumerable egy adott elem elemeit.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?