SessionParameter Classe

Définition

Lie la valeur d’une variable de session à un objet de paramètre.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
Héritage
SessionParameter

Exemples

L’exemple suivant montre comment utiliser un SessionParameter objet.The following example shows how to use a SessionParameter object. L’exemple suppose qu’une autre page a stocké une valeur d’ID d’employé dans une empidvariable de session nommée.The example assumes that another page has stored an employee ID value in a session variable named empid. La page d’exemple utilise empid la variable de session Where dans la clause d’une requête et affiche le résultat de la requête GridView dans un contrôle.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. Étant donné DefaultValue que la propriété SessionParameter de l’objet est définie sur 5, les données de l’enregistrement employeeID ayant la valeur 5 sont toujours affichées si aucune variable de session empid nommée n’est définie avant d’exécuter l’exemple.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>

Remarques

Un SessionParameter objet est généralement utilisé pour inclure la valeur d’une HttpSessionState variable dans la Where clause d’une requête de base de données.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 propriété identifie la variable de session à partir SessionParameter de laquelle récupère une valeur.The SessionField property identifies the session variable from which the SessionParameter retrieves a value.

Notes

Les contrôles qui lient des données à un paramètre à SessionParameter l’aide d’un objet peuvent lever une exception si la variable de session spécifiée n’est pas définie.Controls that bind data to a parameter by using a SessionParameter object might throw an exception if the specified session variable is not set. Pour éviter cette erreur (le cas échéant), définissez DefaultValue la propriété.To avoid this error (where appropriate), set the DefaultValue property.

Constructeurs

SessionParameter()

Initialise une nouvelle instance sans nom de la classe SessionParameter.Initializes a new unnamed instance of the SessionParameter class.

SessionParameter(SessionParameter)

Initialise une nouvelle instance de la classe SessionParameter avec les valeurs de l'instance spécifiée par le paramètre original.Initializes a new instance of the SessionParameter class with the values of the instance specified by the original parameter.

SessionParameter(String, DbType, String)

Initialise une nouvelle instance de la classe SessionParameter à l'aide du nom et du type spécifiés, puis en liant le paramètre à la paire nom/valeur d'état de session spécifiée.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. Ce constructeur est destiné aux types de base de données.This constructor is for database types.

SessionParameter(String, String)

Initialise une nouvelle instance nommée de la classe SessionParameter à l'aide de la chaîne spécifiée pour identifier la paire nom/valeur d'état de session à lier.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)

Initialise une nouvelle instance nommée et fortement typée de la classe SessionParameter à l'aide de la chaîne spécifiée pour identifier la paire nom/valeur d'état de session à lier.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.

Propriétés

ConvertEmptyStringToNull

Obtient ou définit une valeur indiquant si la valeur à laquelle l'objet Parameter est lié doit être convertie en null si elle est 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.

(Hérité de Parameter)
DbType

Obtient ou définit le type de base de données du paramètre.Gets or sets the database type of the parameter.

(Hérité de Parameter)
DefaultValue

Spécifie une valeur par défaut pour le paramètre, à condition que la valeur à laquelle le paramètre est lié à ne soit pas initialisée lorsque la méthode Evaluate(HttpContext, Control) est appelée.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.

(Hérité de Parameter)
Direction

Indique si l'objet Parameter est utilisé pour lier une valeur à un contrôle ou si le contrôle peut être utilisé pour modifier la valeur.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Hérité de Parameter)
IsTrackingViewState

Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Hérité de Parameter)
Name

Obtient ou définit le nom du paramètre.Gets or sets the name of the parameter.

(Hérité de Parameter)
SessionField

Obtient ou définit le nom de la variable de session liée au paramètre.Gets or sets the name of the session variable that the parameter binds to.

Size

Obtient ou définit la taille du paramètre.Gets or sets the size of the parameter.

(Hérité de Parameter)
Type

Obtient ou définit le type du paramètre.Gets or sets the type of the parameter.

(Hérité de Parameter)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet Parameter entre plusieurs demandes de la même page.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.

(Hérité de Parameter)

Méthodes

Clone()

Retourne un doublon de l'instance de SessionParameter actuelle.Returns a duplicate of the current SessionParameter instance.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
Evaluate(HttpContext, Control)

Met à jour et retourne la valeur de l'objet SessionParameter.Updates and returns the value of the SessionParameter object.

GetDatabaseType()

Obtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Hérité de Parameter)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.Restores the data source view's previously saved view state.

(Hérité de Parameter)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnParameterChanged()

Appelle la méthode OnParametersChanged(EventArgs) de la collection ParameterCollection qui contient l'objet Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(Hérité de Parameter)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage de l'objet Parameter depuis la publication de la page sur le serveur.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Hérité de Parameter)
SetDirty()

Marque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage.Marks the Parameter object so its state will be recorded in view state.

(Hérité de Parameter)
ToString()

Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente.Converts the value of this instance to its equivalent string representation.

(Hérité de Parameter)
TrackViewState()

Ainsi, l'objet Parameter effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes entre les demandes de la même page.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.

(Hérité de Parameter)

Implémentations d’interfaces explicites

ICloneable.Clone()

Retourne un doublon de l'instance de Parameter actuelle.Returns a duplicate of the current Parameter instance.

(Hérité de Parameter)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Hérité de Parameter)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.Restores the data source view's previously saved view state.

(Hérité de Parameter)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage de l'objet Parameter depuis la publication de la page sur le serveur.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Hérité de Parameter)
IStateManager.TrackViewState()

Ainsi, l'objet Parameter effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes entre les demandes de la même page.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.

(Hérité de Parameter)

S’applique à

Voir aussi