SessionParameter Classe

Definizione

Associa il valore di una variabile di sessione a un oggetto parametro.Binds the value of a session variable to a parameter object.

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
Ereditarietà
SessionParameter

Esempi

Nell'esempio seguente viene illustrato come utilizzare un SessionParameter oggetto.The following example shows how to use a SessionParameter object. Nell'esempio si presuppone che un'altra pagina abbia archiviato un valore di ID dipendente in una empidvariabile di sessione denominata.The example assumes that another page has stored an employee ID value in a session variable named empid. Nella pagina di esempio viene empid utilizzata la variabile di Where sessione nella clausola di una query e viene visualizzato il risultato della query GridView in un controllo.The example page uses the empid session variable in the Where clause of a query and displays the result of the query in a GridView control. Poiché la DefaultValue SessionParameter proprietà dell'oggetto è impostata su 5, i dati per employeeID il record con valore 5 verranno comunque visualizzati se non viene impostata alcuna variabile di sessione denominata empid prima di eseguire l'esempio.Because the DefaultValue property of the SessionParameter object is set to 5, data for the record that has the employeeID value of 5 will still be displayed if no session variable named empid is set before you run the example.

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

Commenti

Un SessionParameter oggetto viene in genere utilizzato per includere il valore di una HttpSessionState variabile nella Where clausola di una query di database.A SessionParameter object is typically used in order to include the value of an HttpSessionState variable in the Where clause of a database query. La SessionField proprietà identifica la variabile di sessione da SessionParameter cui recupera un valore.The SessionField property identifies the session variable from which the SessionParameter retrieves a value.

Nota

I controlli che associano dati a un parametro SessionParameter tramite un oggetto possono generare un'eccezione se la variabile di sessione specificata non è impostata.Controls that bind data to a parameter by using a SessionParameter object might throw an exception if the specified session variable is not set. Per evitare questo errore (se appropriato), impostare la DefaultValue proprietà.To avoid this error (where appropriate), set the DefaultValue property.

Costruttori

SessionParameter()

Inizializza una nuova istanza senza nome della classe SessionParameter.Initializes a new unnamed instance of the SessionParameter class.

SessionParameter(SessionParameter)

Inizializza una nuova istanza della classe SessionParameter con i valori dell'istanza specificata dal parametro original.Initializes a new instance of the SessionParameter class with the values of the instance specified by the original parameter.

SessionParameter(String, DbType, String)

Inizializza una nuova istanza denominata della classe SessionParameter, utilizzando il nome e il tipo specificati e associando il parametro alla coppia nome/valore dello stato sessione specificata.Initializes a new instance of the SessionParameter class, by using the specified name and type, and binding the parameter to the specified session state name/value pair. Questo costruttore è per i tipi di database.This constructor is for database types.

SessionParameter(String, String)

Inizializza una nuova istanza denominata della classe SessionParameter, utilizzando la stringa specificata per identificare la coppia nome/valore dello stato sessione per l'associazione.Initializes a new named instance of the SessionParameter class, using the specified string to identify which session state name/value pair to bind to.

SessionParameter(String, TypeCode, String)

Inizializza una nuova istanza denominata e fortemente tipizzata della classe SessionParameter, utilizzando la stringa specificata per identificare la coppia nome/valore dello stato sessione per l'associazione.Initializes a new named and strongly typed instance of the SessionParameter class, using the specified string to identify which session state name/value pair to bind to.

Proprietà

ConvertEmptyStringToNull

Ottiene o imposta un valore indicante se il valore a cui è associato l'oggetto Parameter deve essere convertito in null se è Empty.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Ereditato da Parameter)
DbType

Ottiene o imposta il tipo di database del parametro.Gets or sets the database type of the parameter.

(Ereditato da Parameter)
DefaultValue

Specifica un valore predefinito per il parametro, se il valore associato al parametro non deve essere inizializzato quando viene chiamato il metodo Evaluate(HttpContext, Control).Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(Ereditato da Parameter)
Direction

Indica se l'oggetto Parameter viene utilizzato per associare un valore a un controllo oppure il controllo può essere utilizzato per la modifica del valore.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Ereditato da Parameter)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Ereditato da Parameter)
Name

Ottiene o imposta il nome del parametro.Gets or sets the name of the parameter.

(Ereditato da Parameter)
SessionField

Ottiene o imposta il nome della variabile di sessione a cui si associa il parametro.Gets or sets the name of the session variable that the parameter binds to.

Size

Ottiene o imposta le dimensioni del parametro.Gets or sets the size of the parameter.

(Ereditato da Parameter)
Type

Ottiene o imposta il tipo di parametro.Gets or sets the type of the parameter.

(Ereditato da Parameter)
ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto Parameter tra più richieste per la stessa pagina.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page.

(Ereditato da Parameter)

Metodi

Clone()

Restituisce un duplicato dell'istanza SessionParameter corrente.Returns a duplicate of the current SessionParameter instance.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Evaluate(HttpContext, Control)

Viene aggiornato e restituisce il valore dell'oggetto SessionParameter.Updates and returns the value of the SessionParameter object.

GetDatabaseType()

Ottiene il valore DbType che è equivalente al tipo CLR dell'istanza corrente di Parameter.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Ereditato da Parameter)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.Restores the data source view's previously saved view state.

(Ereditato da Parameter)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnParameterChanged()

Chiame il metodo OnParametersChanged(EventArgs) dell'insieme ParameterCollection che contiene l'oggetto Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(Ereditato da Parameter)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto Parameter dal momento in cui è stato eseguito il postback della pagina al server.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Ereditato da Parameter)
SetDirty()

Contrassegna l'oggetto Parameter in modo che il relativo stato venga registrato in stato di visualizzazione.Marks the Parameter object so its state will be recorded in view state.

(Ereditato da Parameter)
ToString()

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.Converts the value of this instance to its equivalent string representation.

(Ereditato da Parameter)
TrackViewState()

Mediante questo metodo l'oggetto Parameter tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che vengono memorizzate nell'oggetto ViewState del controllo e mantenute nelle richieste della stessa pagina.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Ereditato da Parameter)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()

Restituisce un duplicato dell'istanza Parameter corrente.Returns a duplicate of the current Parameter instance.

(Ereditato da Parameter)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Ereditato da Parameter)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.Restores the data source view's previously saved view state.

(Ereditato da Parameter)
IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto Parameter dal momento in cui è stato eseguito il postback della pagina al server.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Ereditato da Parameter)
IStateManager.TrackViewState()

Mediante questo metodo l'oggetto Parameter tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che vengono memorizzate nell'oggetto ViewState del controllo e mantenute nelle richieste della stessa pagina.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Ereditato da Parameter)

Si applica a

Vedi anche