Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ParameterCollection-Klasse

.NET Framework 4.5

Andere Versionen

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

Vererbungshierarchie

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public class ParameterCollection : StateManagedCollection

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

Konstruktoren

	Name	Beschreibung
	ParameterCollection	Initialisiert die Klasse zur Verwendung durch eine geerbte Klasseninstanz. Dieser Konstruktor kann nur von einer geerbten Klasse aufgerufen werden.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Count	Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Von StateManagedCollection geerbt.)
	Item[Int32]	Ruft das Parameter-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.
	Item[String]	Ruft das Parameter-Objekt mit dem angegebenen Namen in der Auflistung ab oder legt dieses fest.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Add(Parameter)	Fügt das angegebene Parameter-Objekt an das Ende der Auflistung an.
	Add(String, String)	Erstellt ein Parameter-Objekt mit dem angegebenen Namen und Standardwert und hängt es an das Ende der Auflistung an.
	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.
	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.
	Clear	Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
	Contains	Ermittelt, ob die ParameterCollection-Auflistung einen bestimmten Wert enthält.
	CopyTo(Array, Int32)	Kopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird. (Von StateManagedCollection geerbt.)
	CopyTo(Parameter[], Int32)	Kopiert einen angegebenen Index eines Parameterarrays in die Parameterauflistung.
	CreateKnownType	Erstellt eine Instanz eines Parameter-Standardobjekts. (Überschreibt StateManagedCollection.CreateKnownType(Int32).)
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetEnumerator	Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Von StateManagedCollection geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetKnownTypes	Ruft ein Array von Parameter-Typen ab, die die ParameterCollection-Auflistung enthalten kann. (Überschreibt StateManagedCollection.GetKnownTypes().)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetValues	Ruft eine geordnete Auflistung von Parameter-Objektnamen und ihren entsprechenden Werten ab, die aktuell in der Auflistung enthalten sind.
	IndexOf	Bestimmt den Index eines angegebenen Parameter-Objekts in der ParameterCollection-Auflistung.
	Insert	Fügt das angegebene Parameter-Objekt am angegebenen Index in die ParameterCollection-Auflistung ein.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	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.)
	OnClearComplete	Führt nach dem Löschen des Inhalts der Auflistung zusätzliche benutzerdefinierte Prozesse aus. (Überschreibt StateManagedCollection.OnClearComplete().)
	OnInsert	Tritt ein, bevor die Insert-Methode aufgerufen wird. (Überschreibt StateManagedCollection.OnInsert(Int32, Object).)
	OnInsertComplete	Tritt ein, nachdem die Insert-Methode abgeschlossen ist. (Überschreibt StateManagedCollection.OnInsertComplete(Int32, Object).)
	OnParametersChanged	Löst das ParametersChanged-Ereignis aus.
	OnRemove	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Remove-Methode oder die RemoveAt-Methode das angegebene Element aus der Auflistung entfernt. (Von StateManagedCollection geerbt.)
	OnRemoveComplete	Tritt ein, nachdem die Remove-Methode abgeschlossen ist. (Überschreibt StateManagedCollection.OnRemoveComplete(Int32, Object).)
	OnValidate	Führt zusätzliche benutzerdefinierte Prozesse beim Validieren eines Werts aus. (Überschreibt StateManagedCollection.OnValidate(Object).)
	Remove	Entfernt das angegebene Parameter-Objekt aus der ParameterCollection-Auflistung.
	RemoveAt	Entfernt das Parameter-Objekt am angegebenen Index aus der ParameterCollection-Auflistung.
	SetDirty	Erzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
	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).)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	UpdateValues	Durchläuft die in der Auflistung enthaltenen Parameter-Objekte und ruft die Evaluate-Methode für jedes dieser Objekte auf.

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	ParametersChanged	Tritt ein, wenn sich der Zustand von einem oder mehreren in der Auflistung enthaltenen Parameter-Objekten ändert.

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	ICollection.Count	Infrastruktur. Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Von StateManagedCollection geerbt.)
	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.)
	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.)
	IEnumerable.GetEnumerator	Infrastruktur. Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Von StateManagedCollection geerbt.)
	IList.Add	Fügt der StateManagedCollection-Auflistung ein Element hinzu. (Von StateManagedCollection geerbt.)
	IList.Clear	Infrastruktur. Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
	IList.Contains	Ermittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält. (Von StateManagedCollection geerbt.)
	IList.IndexOf	Bestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
	IList.Insert	Fügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein. (Von StateManagedCollection geerbt.)
	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.)
	IList.IsReadOnly	Infrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung schreibgeschützt ist. (Von StateManagedCollection geerbt.)
	IList.Item	Infrastruktur. Ruft das IStateManager-Element am angegebenen Index ab. (Von StateManagedCollection geerbt.)
	IList.Remove	Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung. (Von StateManagedCollection geerbt.)
	IList.RemoveAt	Entfernt das IStateManager-Element am angegebenen Index. (Von StateManagedCollection geerbt.)
	IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert. (Von StateManagedCollection geerbt.)
	IStateManager.LoadViewState	Stellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her. (Von StateManagedCollection geerbt.)
	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.)
	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

Hinweise

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
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 finden Sie unter Script Exploits Overview.

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

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

Beispiele

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

Versionsinformationen

.NET Framework

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

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Web.UI.WebControls-Namespace

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN