Freigeben über

SessionParameter Klasse

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Bindet den Wert einer Sitzungsvariable 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

Das folgende Beispiel zeigt, wie ein SessionParameter Objekt verwendet wird. Im Beispiel wird davon ausgegangen, dass eine andere Seite einen Mitarbeiter-ID-Wert in einer Sitzungsvariable namens empidgespeichert hat. Die Beispielseite verwendet die empid Sitzungsvariable 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 keine benannte Sitzungsvariable empid festgelegt ist, bevor Sie das Beispiel ausführen.

<%@ 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 der SessionParameter Wert abgerufen wird.

Hinweis

Steuerelemente, die Daten mithilfe eines SessionParameter Objekts an einen Parameter binden, lösen möglicherweise eine Ausnahme aus, wenn die angegebene Sitzungsvariable nicht festgelegt ist. Um diesen Fehler (sofern zutreffend) zu vermeiden, legen Sie die DefaultValue Eigenschaft fest.

Konstruktoren

Name Beschreibung
SessionParameter()

Initialisiert eine neue unbenannte Instanz der SessionParameter Klasse.
SessionParameter(SessionParameter)

Initialisiert eine neue Instanz der SessionParameter Klasse mit den Werten der vom Parameter angegebenen original Instanz.
SessionParameter(String, DbType, String)

Initialisiert eine neue Instanz der SessionParameter Klasse mithilfe des angegebenen Namens und Typs und binden den Parameter an das angegebene Sitzungszustandsname/Wertpaar. Dieser Konstruktor ist für Datenbanktypen vorgesehen.
SessionParameter(String, String)

Initialisiert eine neue benannte Instanz der SessionParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welches Sitzungszustandsname/Wertpaar gebunden werden soll.
SessionParameter(String, TypeCode, String)

Initialisiert eine neue benannte und stark typierte Instanz der SessionParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welches Sitzungszustandsname/Wertpaar gebunden werden soll.

Eigenschaften

Name Beschreibung
ConvertEmptyStringToNull

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Wert, an den das Parameter Objekt gebunden ist, konvertiert null werden soll, wenn es ist Empty.

(Geerbt von Parameter)
DbType

Dient zum Abrufen oder Festlegen des Datenbanktyps des Parameters.

(Geerbt von Parameter)
DefaultValue

Gibt einen Standardwert für den Parameter an, sollte der Wert, an den der Parameter gebunden ist, nicht initialisiert werden, wenn die Evaluate(HttpContext, Control) Methode aufgerufen wird.

(Geerbt von Parameter)
Direction

Gibt an, ob das Parameter Objekt verwendet wird, um einen Wert an ein Steuerelement zu binden, oder das Steuerelement kann verwendet werden, um den Wert zu ändern.

(Geerbt von Parameter)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter Objekt Änderungen am Ansichtszustand speichert.

(Geerbt von Parameter)
Name

Dient zum Abrufen oder Festlegen des Namens des Parameters.

(Geerbt von Parameter)
SessionField

Ruft den Namen der Sitzungsvariablen ab, an die der Parameter gebunden ist, oder legt diesen fest.
Size

Dient zum Abrufen oder Festlegen der Größe des Parameters.

(Geerbt von Parameter)
Type

Dient zum Abrufen oder Festlegen des Typs des Parameters.

(Geerbt von Parameter)
ViewState

Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Parameter Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können.

(Geerbt von Parameter)

Methoden

Name Beschreibung
Clone()

Gibt ein Duplikat der aktuellen SessionParameter Instanz zurück.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
Evaluate(HttpContext, Control)

Aktualisiert und gibt den Wert des SessionParameter Objekts zurück.
GetDatabaseType()

Ruft den DbType Wert ab, der dem CLR-Typ der aktuellen Parameter Instanz entspricht.

(Geerbt von Parameter)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her.

(Geerbt von Parameter)
MemberwiseClone()

Erstellt eine flache Kopie der 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 wieder auf dem Server gepostet wurde.

(Geerbt von Parameter)
SetDirty()

Markiert das Parameter Objekt so, dass 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 am Ansichtszustand nachverfolgt, sodass sie im Objekt des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können.

(Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

Name Beschreibung
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 am Ansichtszustand speichert.

(Geerbt von Parameter)
IStateManager.LoadViewState(Object)

Stellt den zuvor 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 wieder auf dem Server gepostet wurde.

(Geerbt von Parameter)
IStateManager.TrackViewState()

Bewirkt, dass das Parameter Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im Objekt des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können.

(Geerbt von Parameter)

Gilt für:

Weitere Informationen