ParameterCollection Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Auflistung von Parameter und Parameterabgeleiteten Objekten dar, die von Datenquellensteuerelementen in erweiterten Datenbindungsszenarien verwendet werden.

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

Vererbung: Object

StateManagedCollection
ParameterCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein AccessDataSource Steuerelement und ein FormParameter Steuerelement verwenden, um Informationen aus einer Microsoft Access-Datenbank in einem GridView Steuerelement anzuzeigen. Das FormParameter Objekt wird der Auflistung mithilfe der SelectParameters Add Methode hinzugefügt.

Von Bedeutung

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

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

Hinweise

Die ParameterCollection Klasse stellt eine Auflistung von Objekten dar, die Parameter in erweiterten Datenbindungsszenarien mit Datenquellensteuerelementen verwendet werden. Die Parameter Objekte werden verwendet, um die in lokalen Page Variablen, HTTP-Cookies, Sitzungsvariablen und anderen Steuerelementen enthaltenen Werte an Datenquellensteuerelemente zu binden, wenn Daten abgerufen, aktualisiert, gelöscht und eingefügt werden.

Verwenden Sie die ParameterCollection Klasse, um einen Satz von Parameter Objekten programmgesteuert zu verwalten. Sie können Objekte mithilfe der entsprechenden Methoden der ParameterCollection Klasse hinzufügen, einfügen und entfernenParameter. Verwenden Sie eine der folgenden Methoden, um Objekte programmgesteuert aus einer Auflistung abzurufen Parameter :

Verwenden Sie den Indexer, um ein einzelnes Parameter Objekt aus der Auflistung anhand des Namens oder der Arraynotation abzurufen.
Verwenden Sie die GetEnumerator Methode, um ein -implementiertes System.Collections.IEnumeratorObjekt zu erstellen, das dann zum Abrufen von Elementen aus der Auflistung verwendet werden kann.

Die Count Eigenschaft gibt die Gesamtanzahl der Elemente in der Auflistung an und wird verwendet, um die obere Grenze der Auflistung zu bestimmen. Sie können Elemente aus der Auflistung hinzufügen und entfernen, indem Sie die AddMethoden , Insert, und Remove RemoveAt dies verwenden.

Je nach Implementierung und Semantik eines bestimmten Datenquellensteuerelements kann die Reihenfolge, in der die Parameter in der ParameterCollection Auflistung gespeichert werden, wichtig sein. Wenn Sie z. B. das SqlDataSource Steuerelement als ODBC-Datenquelle verwenden, muss die Reihenfolge der Parameter Objekte in der ParameterCollection Auflistung mit der Reihenfolge der Parameter in den von Ihnen verwendeten parametrisierten SQL-Abfragen identisch sein. Bei Verwendung des SqlDataSource Steuerelements mit Microsoft SQL Server ist die Reihenfolge der Parameter Objekte jedoch nicht wichtig.

Von Bedeutung

Wenn Sie Datenquellensteuerelemente verwenden, werden Werte ohne Überprüfung in Befehlsparameter eingefügt, was eine potenzielle Sicherheitsrisiken darstellt. Verwenden Sie ein Ereignis im Datenquellensteuerelement, um Parameterwerte zu überprüfen, bevor der Befehl ausgeführt wird. Weitere Informationen finden Sie unter Script Exploits Overview.

In der folgenden Tabelle sind die verschiedenen Parameterklassen und deren Verwendung aufgeführt.

Parameterklasse	Beschreibung
Parameter	Die Basisparameterklasse. Verwenden Sie sie, um eine Bindung an eine lokale Variable oder eine statische Zeichenfolge mithilfe der DefaultValue Eigenschaft herzustellen.
ControlParameter	Ein Parameter, der verwendet werden kann, um eine Bindung an die Eigenschaft oder den Rückgabewert einer Methode eines Steuerelements durchzuführen.
CookieParameter	Ein Parameter, der zum Binden an den Wert eines Cookies verwendet werden kann.
FormParameter	Ein Parameter, der zum Binden an ein Attribut der aktuellen Web Forms-Seite verwendet werden kann.
QueryStringParameter	Ein Parameter, der zum Binden an einen Wert verwendet werden kann, der an eine Web Forms-Seite in einer Abfragezeichenfolge übergeben wird.
SessionParameter	Ein Parameter, der zum Binden an den Wert einer Sitzungsvariable verwendet werden kann.
ProfileParameter	Ein Parameter, der zum Binden an den Wert einer ASP.NET Profile-Eigenschaft verwendet werden kann.

Konstruktoren

Name	Beschreibung
ParameterCollection()	Initialisiert die Klasse für die Verwendung durch eine geerbte Klasseninstanz. Dieser Konstruktor kann nur von einer geerbten Klasse aufgerufen werden.

Eigenschaften

Name	Beschreibung
Count	Ruft die Anzahl der In der StateManagedCollection Auflistung enthaltenen Elemente ab. (Geerbt von StateManagedCollection)
Item[Int32]	Dient zum Abrufen oder Festlegen des Parameter Objekts am angegebenen Index in der Auflistung.
Item[String]	Dient zum Abrufen oder Festlegen des Parameter Objekts mit dem angegebenen Namen in der Auflistung.

Methoden

Name	Beschreibung
Add(Parameter)	Fügt das angegebene Parameter Objekt an das Ende der Auflistung an.
Add(String, DbType, String)	Erstellt ein Parameter Objekt mit dem angegebenen Namen, dem Datenbanktyp und dem Standardwert und fügt es am Ende der Auflistung hinzu.
Add(String, String)	Erstellt ein Parameter Objekt mit dem angegebenen Namen und Standardwert und fügt es an das Ende der Auflistung an.
Add(String, TypeCode, String)	Erstellt ein Parameter Objekt mit dem angegebenen Namen, TypeCodedem Standardwert und fügt es an das Ende der Auflistung an.
Clear()	Entfernt alle Elemente aus der StateManagedCollection Auflistung. (Geerbt von StateManagedCollection)
Contains(Parameter)	Bestimmt, ob die ParameterCollection Auflistung einen bestimmten Wert enthält.
CopyTo(Array, Int32)	Kopiert die Elemente der StateManagedCollection Auflistung in ein Array, beginnend bei einem bestimmten Arrayindex. (Geerbt von StateManagedCollection)
CopyTo(Parameter[], Int32)	Kopiert einen angegebenen Index eines Parameterarrays in die Parameterauflistung.
CreateKnownType(Int32)	Erstellt eine Instanz eines Standardobjekts Parameter .
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetEnumerator()	Gibt einen Iterator zurück, der die StateManagedCollection Auflistung durchläuft. (Geerbt von StateManagedCollection)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetKnownTypes()	Ruft ein Array von Parameter Typen ab, die die ParameterCollection Auflistung enthalten kann.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValues(HttpContext, Control)	Ruft eine sortierte Auflistung von Parameter Objektnamen und deren entsprechenden Werte ab, die derzeit in der Auflistung enthalten sind.
IndexOf(Parameter)	Bestimmt den Index eines angegebenen Parameter Objekts in der ParameterCollection Auflistung.
Insert(Int32, Parameter)	Fügt das angegebene Parameter Objekt in die ParameterCollection Auflistung am angegebenen Index ein.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnClear()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden zusätzliche Aufgaben ausgeführt, bevor die Clear() Methode alle Elemente aus der Auflistung entfernt. (Geerbt von StateManagedCollection)
OnClearComplete()	Führt zusätzliche benutzerdefinierte Prozesse aus, nachdem der Inhalt der Auflistung gelöscht wurde.
OnInsert(Int32, Object)	Tritt auf, bevor die Insert(Int32, Parameter) Methode aufgerufen wird.
OnInsertComplete(Int32, Object)	Tritt auf, nachdem die Insert(Int32, Parameter) Methode abgeschlossen wurde.
OnParametersChanged(EventArgs)	Löst das ParametersChanged-Ereignis aus.
OnRemove(Int32, Object)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden zusätzliche Aufgaben ausgeführt, bevor das IList.Remove(Object)IList.RemoveAt(Int32) angegebene Element aus der Auflistung entfernt wird. (Geerbt von StateManagedCollection)
OnRemoveComplete(Int32, Object)	Tritt auf, nachdem die Remove(Parameter) Methode abgeschlossen wurde.
OnValidate(Object)	Führt beim Überprüfen eines Werts zusätzliche benutzerdefinierte Prozesse aus.
Remove(Parameter)	Entfernt das angegebene Parameter Objekt aus der ParameterCollection Auflistung.
RemoveAt(Int32)	Entfernt das Parameter Objekt am angegebenen Index aus der ParameterCollection Auflistung.
SetDirty()	Erzwingt, dass die gesamte StateManagedCollection Sammlung in den Ansichtszustand serialisiert wird. (Geerbt von StateManagedCollection)
SetDirtyObject(Object)	Markiert das angegebene Parameter Objekt als geändert seit dem letzten Laden oder Speichern aus dem Ansichtszustand.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UpdateValues(HttpContext, Control)	Durchläuft die Parameter objekte, die in der Auflistung enthalten sind, und ruft die `Evaluate` Methode für jedes Objekt auf.

Ereignisse

Name	Beschreibung
ParametersChanged	Tritt auf, wenn ein oder Parameter mehrere Objekte, die im Auflistungsstatus enthalten sind, geändert werden.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICollection.Count	Ruft die Anzahl der In der StateManagedCollection Auflistung enthaltenen Elemente ab. (Geerbt von StateManagedCollection)
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob die StateManagedCollection Auflistung synchronisiert wird (Threadsicher). Diese Methode gibt in allen Fällen zurück `false` . (Geerbt von StateManagedCollection)
ICollection.SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die StateManagedCollection Auflistung verwendet werden kann. Diese Methode gibt in allen Fällen zurück `null` . (Geerbt von StateManagedCollection)
IEnumerable.GetEnumerator()	Gibt einen Iterator zurück, der die StateManagedCollection Auflistung durchläuft. (Geerbt von StateManagedCollection)
IList.Add(Object)	Fügt der StateManagedCollection Auflistung ein Element hinzu. (Geerbt von StateManagedCollection)
IList.Clear()	Entfernt alle Elemente aus der StateManagedCollection Auflistung. (Geerbt von StateManagedCollection)
IList.Contains(Object)	Bestimmt, ob die StateManagedCollection Auflistung einen bestimmten Wert enthält. (Geerbt von StateManagedCollection)
IList.IndexOf(Object)	Bestimmt den Index eines angegebenen Elements in der StateManagedCollection Auflistung. (Geerbt von StateManagedCollection)
IList.Insert(Int32, Object)	Fügt ein Element in die StateManagedCollection Auflistung am angegebenen Index ein. (Geerbt von StateManagedCollection)
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die StateManagedCollection Auflistung eine feste Größe aufweist. Diese Methode gibt in allen Fällen zurück `false` . (Geerbt von StateManagedCollection)
IList.IsReadOnly	Ruft einen Wert ab, der angibt, ob die StateManagedCollection Auflistung schreibgeschützt ist. (Geerbt von StateManagedCollection)
IList.Item[Int32]	Ruft das IStateManager Element am angegebenen Index ab. (Geerbt von StateManagedCollection)
IList.Remove(Object)	Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection Auflistung. (Geerbt von StateManagedCollection)
IList.RemoveAt(Int32)	Entfernt das IStateManager Element am angegebenen Index. (Geerbt von StateManagedCollection)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die StateManagedCollection Auflistung Änderungen am Ansichtszustand speichert. (Geerbt von StateManagedCollection)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtsstatus der StateManagedCollection Auflistung und der IStateManager darin enthaltenen Elemente wieder her. (Geerbt von StateManagedCollection)
IStateManager.SaveViewState()	Speichert die Änderungen an der StateManagedCollection Auflistung und jedes IStateManager Objekt, das sie enthält, seit der Zeitpunkt, zu dem die Seite wieder auf dem Server gepostet wurde. (Geerbt von StateManagedCollection)
IStateManager.TrackViewState()	Bewirkt, dass die StateManagedCollection Auflistung und jedes der IStateManager darin enthaltenen Objekte Änderungen am Ansichtszustand nachverfolgt, sodass sie über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von StateManagedCollection)

Erweiterungsmethoden

Name	Beschreibung
AsParallel(IEnumerable)	Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Wandelt eine IEnumerable in eine IQueryableum.
Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
OfType<TResult>(IEnumerable)	Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?