SessionParameter Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt de waarde van een sessievariabele gebonden aan een parameterobject.

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

Overname: Object

Parameter
SessionParameter

Voorbeelden

In het volgende voorbeeld ziet u hoe u een SessionParameter object gebruikt. In het voorbeeld wordt ervan uitgegaan dat een andere pagina een waarde voor de werknemer-id heeft opgeslagen in een sessievariabele met de naam empid. De voorbeeldpagina maakt gebruik van de empid sessievariabele in de Where component van een query en geeft het resultaat van de query in een GridView besturingselement weer. Omdat de DefaultValue eigenschap van het SessionParameter object is ingesteld op 5, worden gegevens voor de record met de employeeID waarde 5 nog steeds weergegeven als er geen sessievariabele met de naam empid is ingesteld voordat u het voorbeeld uitvoert.

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

Opmerkingen

Een SessionParameter object wordt doorgaans gebruikt om de waarde van een HttpSessionState variabele in de Where component van een databasequery op te nemen. De SessionField eigenschap identificeert de sessievariabele waaruit de SessionParameter waarde wordt opgehaald.

Note

Besturingselementen waarmee gegevens aan een parameter worden gekoppeld met behulp van een SessionParameter object, kunnen een uitzondering genereren als de opgegeven sessievariabele niet is ingesteld. Als u deze fout (indien van toepassing) wilt voorkomen, stelt u de DefaultValue eigenschap in.

Constructors

Name	Description
SessionParameter()	Initialiseert een nieuw niet-benoemd exemplaar van de SessionParameter klasse.
SessionParameter(SessionParameter)	Initialiseert een nieuw exemplaar van de SessionParameter klasse met de waarden van het exemplaar dat is opgegeven door de `original` parameter.
SessionParameter(String, DbType, String)	Initialiseert een nieuw exemplaar van de SessionParameter klasse, met behulp van de opgegeven naam en het opgegeven type, en koppelt de parameter aan de opgegeven sessiestatusnaam/waardepaar. Deze constructor is bedoeld voor databasetypen.
SessionParameter(String, String)	Initialiseert een nieuw benoemd exemplaar van de SessionParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welke sessiestatusnaam/waardepaar moet worden gekoppeld.
SessionParameter(String, TypeCode, String)	Initialiseert een nieuwe benoemde en sterk getypte instantie van de SessionParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welke sessiestatusnaam/waardepaar moet worden gekoppeld.

Eigenschappen

Name	Description
ConvertEmptyStringToNull	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de waarde waarnaar het Parameter object is gebonden, moet worden geconverteerd `null` als dit het geval is Empty. (Overgenomen van Parameter)
DbType	Hiermee haalt u het databasetype van de parameter op of stelt u deze in. (Overgenomen van Parameter)
DefaultValue	Hiermee geeft u een standaardwaarde voor de parameter op, moet de waarde die de parameter moet worden niet geïnitialiseerd wanneer de Evaluate(HttpContext, Control) methode wordt aangeroepen. (Overgenomen van Parameter)
Direction	Hiermee wordt aangegeven of het Parameter object wordt gebruikt om een waarde aan een besturingselement te binden, of het besturingselement kan worden gebruikt om de waarde te wijzigen. (Overgenomen van Parameter)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het Parameter object wijzigingen opslaat in de weergavestatus. (Overgenomen van Parameter)
Name	Hiermee haalt u de naam van de parameter op of stelt u deze in. (Overgenomen van Parameter)
SessionField	Hiermee haalt u de naam op van de sessievariabele waaraan de parameter wordt gekoppeld.
Size	Hiermee haalt u de grootte van de parameter op of stelt u deze in. (Overgenomen van Parameter)
Type	Hiermee haalt u het type van de parameter op of stelt u deze in. (Overgenomen van Parameter)
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een Parameter object kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Methoden

Name	Description
Clone()	Retourneert een duplicaat van het huidige SessionParameter exemplaar.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
Evaluate(HttpContext, Control)	Hiermee wordt de waarde van het SessionParameter object bijgewerkt en geretourneerd.
GetDatabaseType()	Hiermee haalt u de DbType waarde op die gelijk is aan het CLR-type van het huidige Parameter exemplaar. (Overgenomen van Parameter)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van Parameter)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnParameterChanged()	Roept de OnParametersChanged(EventArgs) methode aan van de ParameterCollection verzameling die het Parameter object bevat. (Overgenomen van Parameter)
SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het Parameter object sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Parameter)
SetDirty()	Hiermee wordt het Parameter object gemarkeerd, zodat de status ervan wordt vastgelegd in de weergavestatus. (Overgenomen van Parameter)
ToString()	Converteert de waarde van dit exemplaar naar de equivalente tekenreeksweergave. (Overgenomen van Parameter)
TrackViewState()	Hiermee zorgt u ervoor dat het Parameter object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in het object van ViewState het besturingselement en kunnen worden bewaard in aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Expliciete interface-implementaties

Name	Description
ICloneable.Clone()	Retourneert een duplicaat van het huidige Parameter exemplaar. (Overgenomen van Parameter)
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het Parameter object wijzigingen opslaat in de weergavestatus. (Overgenomen van Parameter)
IStateManager.LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van Parameter)
IStateManager.SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het Parameter object sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Parameter)
IStateManager.TrackViewState()	Hiermee zorgt u ervoor dat het Parameter object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in het object van ViewState het besturingselement en kunnen worden bewaard in aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?