SessionParameter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Associa il valore di una variabile di sessione a un oggetto parametro.

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à: Object

Parameter
SessionParameter

Esempio

Nell'esempio seguente viene illustrato come usare un SessionParameter oggetto. L'esempio presuppone che un'altra pagina abbia archiviato un valore ID dipendente in una variabile di sessione denominata empid. La pagina di esempio usa la empid variabile di sessione nella Where clausola di una query e visualizza il risultato della query in un GridView controllo. Poiché la DefaultValue proprietà dell'oggetto SessionParameter è impostata su 5, i dati per il record con il employeeID valore 5 verranno comunque visualizzati se non viene impostata alcuna variabile di sessione denominata empid prima di eseguire l'esempio.

<%@ 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 usato per includere il valore di una variabile nella Where clausola di una HttpSessionState query di database. La SessionField proprietà identifica la variabile di sessione da cui viene SessionParameter recuperato un valore.

Nota

I controlli che associano dati a un parametro usando un oggetto potrebbero generare un'eccezione SessionParameter se la variabile di sessione specificata non è impostata. Per evitare questo errore (se appropriato), impostare la DefaultValue proprietà.

Costruttori

SessionParameter()	Inizializza una nuova istanza senza nome della classe SessionParameter.
SessionParameter(SessionParameter)	Inizializza una nuova istanza della classe SessionParameter con i valori dell'istanza specificata dal parametro `original`.
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. Questo costruttore è per i tipi di database.
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.
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.

Proprietà

ConvertEmptyStringToNull	Ottiene o imposta un valore indicante se il valore a cui è associato l'oggetto Parameter deve essere convertito in `null` se è Empty. (Ereditato da Parameter)
DbType	Ottiene o imposta il tipo di database del parametro. (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). (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. (Ereditato da Parameter)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da Parameter)
Name	Ottiene o imposta il nome del parametro. (Ereditato da Parameter)
SessionField	Ottiene o imposta il nome della variabile di sessione a cui si associa il parametro.
Size	Ottiene o imposta le dimensioni del parametro. (Ereditato da Parameter)
Type	Ottiene o imposta il tipo del parametro. (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. (Ereditato da Parameter)

Metodi

Clone()	Restituisce un duplicato dell'istanza SessionParameter corrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Evaluate(HttpContext, Control)	Viene aggiornato e restituisce il valore dell'oggetto SessionParameter.
GetDatabaseType()	Ottiene il valore DbType che è equivalente al tipo CLR dell'istanza corrente di Parameter. (Ereditato da Parameter)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadViewState(Object)	Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati. (Ereditato da Parameter)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnParameterChanged()	Chiame il metodo OnParametersChanged(EventArgs) dell'insieme ParameterCollection che contiene l'oggetto Parameter. (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. (Ereditato da Parameter)
SetDirty()	Contrassegna l'oggetto Parameter in modo che il relativo stato venga registrato in stato di visualizzazione. (Ereditato da Parameter)
ToString()	Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa. (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. (Ereditato da Parameter)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()	Restituisce un duplicato dell'istanza Parameter corrente. (Ereditato da Parameter)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da Parameter)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati. (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. (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. (Ereditato da Parameter)

Si applica a