SessionParameter Klasse

Referenz

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.

Bindet den Wert einer Sitzungsvariablen an ein Parameterobjekt.

public ref class SessionParameter : System::Web::UI::WebControls::Parameter

public class SessionParameter : System.Web.UI.WebControls.Parameter

type SessionParameter = class
    inherit Parameter

Public Class SessionParameter
Inherits Parameter

Vererbung: Object

Parameter
SessionParameter

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein SessionParameter -Objekt verwendet wird. Im Beispiel wird davon ausgegangen, dass eine andere Seite einen Mitarbeiter-ID-Wert in einer Sitzungsvariablen mit dem Namen empidgespeichert hat. Die Beispielseite verwendet die Sitzungsvariable empid in der Where -Klausel einer Abfrage und zeigt das Ergebnis der Abfrage in einem GridView -Steuerelement an. Da die DefaultValue -Eigenschaft des SessionParameter -Objekts auf 5 festgelegt ist, werden die Daten für den Datensatz mit dem employeeID Wert 5 weiterhin angezeigt, wenn vor dem Ausführen des Beispiels keine Sitzungsvariable mit dem Namen empid festgelegt wird.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <p>Show My Orders:</p>

      <asp:SqlDataSource
          id="OdbcDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=MyOdbcDsn;"
          SelectCommand="SELECT OrderId, CustomerId, OrderDate
                         FROM Orders
                         WHERE EmployeeID = ?
                         ORDER BY CustomerId ASC;">
          <SelectParameters>
              <asp:SessionParameter
                Name="empid"
                SessionField="empid"
                DefaultValue="5" />
          </SelectParameters>
      </asp:SqlDataSource>

      <p>
      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="OdbcDataSource1" />
      </p>
    </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">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <p>Show My Orders:</p>

      <asp:SqlDataSource
          id="OdbcDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=MyOdbcDsn;"
          SelectCommand="SELECT OrderId, CustomerId, OrderDate 
                         FROM Orders 
                         WHERE EmployeeID = ? 
                         ORDER BY CustomerId ASC;">
          <SelectParameters>
              <asp:SessionParameter
                Name="empid"
                SessionField="empid"
                DefaultValue="5" />
          </SelectParameters>
      </asp:SqlDataSource>

      <p>
      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="OdbcDataSource1" />
      </p>
    </form>
  </body>
</html>

Hinweise

Ein SessionParameter -Objekt wird in der Regel verwendet, um den Wert einer HttpSessionState Variablen in die Where -Klausel einer Datenbankabfrage einzuschließen. Die SessionField -Eigenschaft identifiziert die Sitzungsvariable, aus der ein SessionParameter -Wert abgerufen wird.

Hinweis

Steuerelemente, die Daten mithilfe eines SessionParameter -Objekts an einen Parameter binden, können eine Ausnahme auslösen, wenn die angegebene Sitzungsvariable nicht festgelegt ist. Legen Sie die DefaultValue -Eigenschaft fest, um diesen Fehler (falls zutreffend) zu vermeiden.

Konstruktoren

SessionParameter()	Initialisiert eine neue unbenannte Instanz der SessionParameter-Klasse.
SessionParameter(SessionParameter)	Initialisiert eine neue Instanz der SessionParameter-Klasse mit den Werten der Instanz, die vom `original`-Parameter angegeben wird.
SessionParameter(String, DbType, String)	Initialisiert eine neue benannte Instanz der SessionParameter-Klasse mit dem angegebenen Namen und dem angegebenen Typ, und bindet den Parameter an das angegebene Paar aus Name und Wert des Sitzungszustands. Dieser Konstruktor ist für Datenbanktypen vorgesehen.
SessionParameter(String, String)	Initialisiert eine neue benannte Instanz der SessionParameter-Klasse, wobei mit der angegebenen Zeichenfolge das aus Name und Wert des Sitzungszustands bestehende Paar angegeben wird, an das die Bindung erfolgen soll.
SessionParameter(String, TypeCode, String)	Initialisiert eine neu benannte und stark typisierte Instanz der SessionParameter-Klasse, wobei mithilfe der angegebenen Zeichenfolge das Paar aus Name und Wert des Sitzungszustands angegeben wird, an das die Bindung erfolgen soll.

Eigenschaften

ConvertEmptyStringToNull	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das Parameter-Objekt gebunden ist, nach `null` konvertiert werden soll, wenn er Empty ist. (Geerbt von Parameter)
DbType	Ruft den Datenbanktyp des Parameters ab oder legt diesen fest. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, wenn der Wert, an den der Parameter gebunden ist, beim Aufrufen der Evaluate(HttpContext, Control)-Methode nicht initialisiert ist. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
Name	Ruft den Namen des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
SessionField	Ruft den Namen der Sitzungsvariablen ab, an die der Parameter gebunden ist, oder legt diesen fest.
Size	Ruft die Größe des Parameters ab oder legt sie fest. (Geerbt von Parameter)
Type	Ruft den Typ des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Parameter-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Clone()	Gibt ein Duplikat der aktuellen SessionParameter-Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert den Wert des SessionParameter-Objekts und gibt ihn zurück.
GetDatabaseType()	Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnParameterChanged()	Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält. (Geerbt von Parameter)
SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Parameter)
ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Geerbt von Parameter)
TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter-Instanz zurück. (Geerbt von Parameter)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Gilt für:

Freigeben über