Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ParameterCollection-Klasse

.NET Framework 4

Stellt eine Auflistung von Objekten dar, die von Parameter und Parameter abgeleitet sind und von Datenquellen-Steuerelementen in Szenarios mit erweiterter Datenbindung verwendet werden.

System.Object
  System.Web.UI.StateManagedCollection
    System.Web.UI.WebControls.ParameterCollection

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
C#
C++
F#
VB
Kopieren 
public class ParameterCollection : StateManagedCollection

Der ParameterCollection-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode ParameterCollection Initialisiert die Klasse zur Verwendung durch eine geerbte Klasseninstanz. Dieser Konstruktor kann nur von einer geerbten Klasse aufgerufen werden.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Count Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Von StateManagedCollection geerbt.)
Öffentliche Eigenschaft Item[Int32] Ruft das Parameter-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.
Öffentliche Eigenschaft Item[String] Ruft das Parameter-Objekt mit dem angegebenen Namen in der Auflistung ab oder legt dieses fest.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Add(Parameter) Fügt das angegebene Parameter-Objekt an das Ende der Auflistung an.
Öffentliche Methode Add(String, String) Erstellt ein Parameter-Objekt mit dem angegebenen Namen und Standardwert und hängt es an das Ende der Auflistung an.
Öffentliche Methode Add(String, DbType, String) Erstellt ein Parameter-Objekt mit dem angegebenen Namen, Datenbanktyp sowie Standardwert und hängt dieses an das Ende der Auflistung an.
Öffentliche Methode Add(String, TypeCode, String) Erstellt ein Parameter-Objekt mit dem angegebenen Namen, TypeCode und Standardwert, und hängt es an das Ende der Auflistung an.
Öffentliche Methode Clear Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
Öffentliche Methode Contains Ermittelt, ob die ParameterCollection-Auflistung einen bestimmten Wert enthält.
Öffentliche Methode CopyTo(Array, Int32) Kopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird. (Von StateManagedCollection geerbt.)
Öffentliche Methode CopyTo(Parameter[], Int32) Kopiert einen angegebenen Index eines Parameterarrays in die Parameterauflistung.
Geschützte Methode CreateKnownType Erstellt eine Instanz eines Parameter-Standardobjekts. (Überschreibt StateManagedCollection.CreateKnownType(Int32).)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetEnumerator Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Von StateManagedCollection geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Geschützte Methode GetKnownTypes Ruft ein Array von Parameter-Typen ab, die die ParameterCollection-Auflistung enthalten kann. (Überschreibt StateManagedCollection.GetKnownTypes().)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode GetValues Ruft eine geordnete Auflistung von Parameter-Objektnamen und ihren entsprechenden Werten ab, die aktuell in der Auflistung enthalten sind.
Öffentliche Methode IndexOf Bestimmt den Index eines angegebenen Parameter-Objekts in der ParameterCollection-Auflistung.
Öffentliche Methode Insert Fügt das angegebene Parameter-Objekt am angegebenen Index in die ParameterCollection-Auflistung ein.
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode OnClear Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Clear-Methode alle Elemente aus der Auflistung entfernt. (Von StateManagedCollection geerbt.)
Geschützte Methode OnClearComplete Führt nach dem Löschen des Inhalts der Auflistung zusätzliche benutzerdefinierte Prozesse aus. (Überschreibt StateManagedCollection.OnClearComplete().)
Geschützte Methode OnInsert Tritt ein, bevor die Insert-Methode aufgerufen wird. (Überschreibt StateManagedCollection.OnInsert(Int32, Object).)
Geschützte Methode OnInsertComplete Tritt ein, nachdem die Insert-Methode abgeschlossen ist. (Überschreibt StateManagedCollection.OnInsertComplete(Int32, Object).)
Geschützte Methode OnParametersChanged Löst das ParametersChanged-Ereignis aus.
Geschützte Methode OnRemove Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Remove(Object)-Methode oder die RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt. (Von StateManagedCollection geerbt.)
Geschützte Methode OnRemoveComplete Tritt ein, nachdem die Remove-Methode abgeschlossen ist. (Überschreibt StateManagedCollection.OnRemoveComplete(Int32, Object).)
Geschützte Methode OnValidate Führt zusätzliche benutzerdefinierte Prozesse beim Validieren eines Werts aus. (Überschreibt StateManagedCollection.OnValidate(Object).)
Öffentliche Methode Remove Entfernt das angegebene Parameter-Objekt aus der ParameterCollection-Auflistung.
Öffentliche Methode RemoveAt Entfernt das Parameter-Objekt am angegebenen Index aus der ParameterCollection-Auflistung.
Öffentliche Methode SetDirty Erzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
Geschützte Methode SetDirtyObject Markiert das angegebene Parameter-Objekt als geändert, seit es das letzte Mal geladen oder aus dem Ansichtszustand gespeichert wurde. (Überschreibt StateManagedCollection.SetDirtyObject(Object).)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche Methode UpdateValues Durchläuft die in der Auflistung enthaltenen Parameter-Objekte und ruft die Evaluate-Methode für jedes dieser Objekte auf.
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis ParametersChanged Tritt ein, wenn sich der Zustand von einem oder mehreren in der Auflistung enthaltenen Parameter-Objekten ändert.
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Eigenschaft ICollection.Count Infrastruktur. Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft ICollection.IsSynchronized Infrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung synchronisiert (threadsicher) ist. Diese Methode gibt immer false zurück. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft ICollection.SyncRoot Infrastruktur. Ruft ein Objekt ab, mit dem der Zugriff auf die StateManagedCollection-Auflistung synchronisiert werden kann. Diese Methode gibt immer null zurück. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IEnumerable.GetEnumerator Infrastruktur. Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.Add Fügt der StateManagedCollection-Auflistung ein Element hinzu. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.Clear Infrastruktur. Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.Contains Ermittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.IndexOf Bestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.Insert Fügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IList.IsFixedSize Infrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung eine feste Größe hat. Diese Methode gibt immer false zurück. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IList.IsReadOnly Infrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung schreibgeschützt ist. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IList.Item Infrastruktur. Ruft das IStateManager-Element am angegebenen Index ab. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.Remove Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IList.RemoveAt Entfernt das IStateManager-Element am angegebenen Index. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IStateManager.IsTrackingViewState Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IStateManager.LoadViewState Stellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IStateManager.SaveViewState Speichert die Änderungen an der StateManagedCollection-Auflistung und allen darin enthaltenen IStateManager-Objekten seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Von StateManagedCollection geerbt.)
Explizite Schnittstellenimplementierung Private Methode IStateManager.TrackViewState Weist die StateManagedCollection-Auflistung und alle in ihr enthaltenen IStateManager-Objekte an, die Änderungen im Ansichtszustand nachzuverfolgen, sodass diese für die gleiche Seite anforderungsübergreifend beibehalten werden können. (Von StateManagedCollection geerbt.)
Zum Seitenanfang

Die ParameterCollection-Klasse stellt eine Auflistung von Parameter-Objekten dar, die in Szenarios mit erweiterter Datenbindung mit Datenquellen-Steuerelementen verwendet werden. Die Parameter-Objekte werden verwendet, um die in lokalen Page-Variablen, in HTTP-Cookies und in Sitzungsvariablen enthaltenen Werte sowie die Werte anderer Steuerelemente an Datenquellen-Steuerelemente zu binden, wenn Daten abgerufen, aktualisiert, gelöscht oder eingefügt werden.

Mit der ParameterCollection-Klasse können Sie eine Gruppe von Parameter-Objekten programmgesteuert verwalten. Sie können Parameter-Objekte mit den entsprechenden Methoden der ParameterCollection-Klasse hinzufügen, einfügen und entfernen. Verwenden Sie eine der folgenden Methoden, um Parameter-Objekte programmgesteuert aus einer Auflistung abzurufen:

  • Rufen Sie mit dem Indexer anhand des Namens oder unter Verwendung von Arraynotation ein einzelnes Parameter-Objekt aus der Auflistung ab.

  • Erstellen Sie mit der GetEnumerator-Methode ein implementiertes System.Collections.IEnumerator-Objekt, mit dem anschließend Elemente aus der Auflistung abgerufen werden können.

Die Count-Eigenschaft gibt die Gesamtzahl der Elemente in der Auflistung an und wird zum Bestimmen der oberen Grenze der Auflistung verwendet. Mithilfe der Methoden Add, Insert, Remove und RemoveAt können Sie der Auflistung Elemente hinzufügen oder diese daraus entfernen.

Je nach Implementierung und Semantik eines bestimmten Datenquellen-Steuerelements kann die Reihenfolge, in der die Parameter in der ParameterCollection-Auflistung gespeichert sind, 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 verwendeten parametrisierten SQL-Abfragen übereinstimmen. Wenn Sie jedoch das SqlDataSource-Steuerelement mit Microsoft SQL Server verwenden, ist die Reihenfolge der Parameter-Objekte nicht von Bedeutung.

Sicherheitshinweis Sicherheitshinweis

Wenn Sie Datenquellensteuerelemente verwenden, werden Werte ohne Validierung in die Befehlsparameter eingefügt. Dies stellt ein potenzielles Sicherheitsrisiko dar. Verwenden Sie ein Ereignis im Datenquellensteuerelement, um Parameterwerte zu validieren, bevor der Befehl ausgeführt wird. Weitere Informationen hierzu finden Sie unter Übersicht über Skriptangriffe.

In der folgenden Tabelle werden die verschiedenen Parameterklassen und ihre Verwendungsweise aufgelistet.

Parameterklasse

Beschreibungen

Parameter

Die Basisparameterklasse. Verwenden Sie diese, um mit der DefaultValue-Eigenschaft an eine lokale Variable oder eine statische Zeichenfolge zu binden.

ControlParameter

Ein Parameter, der verwendet werden kann, um an die Eigenschaft oder den Methodenrückgabewert eines Steuerelements zu binden.

CookieParameter

Ein Parameter, mit dem an den Wert eines Cookies gebunden werden kann.

FormParameter

Ein Parameter, mit dem an ein Attribut der aktuellen Web Forms-Seite gebunden werden kann.

QueryStringParameter

Ein Parameter, mit dem an einen Wert gebunden werden kann, der in einer Abfragezeichenfolge an eine Web Forms-Seite übergeben wird.

SessionParameter

Ein Parameter, mit dem an den Wert einer Sitzungsvariable gebunden werden kann.

ProfileParameter

Ein Parameter, mit dem an den Wert einer ASP.NET-Profileigenschaft gebunden werden kann.

Im folgenden Codebeispiel wird veranschaulicht, wie Informationen von einer Microsoft Access-Datenbank mithilfe des AccessDataSource-Steuerelements und einem FormParameter in einem GridView-Steuerelement angezeigt werden. Der SelectParameters-Auflistung wird das FormParameter-Objekt mithilfe der Add-Methode hinzugefügt.

Sicherheitshinweis Sicherheitshinweis

In diesem Beispiel ist ein Textfeld für eine Benutzereingabe enthalten. Dies stellt ein potenzielles Sicherheitsrisiko dar. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen hierzu finden Sie unter Übersicht über Skriptangriffe.

C#
VB
Kopieren 

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

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ