Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

SessionParameter, classe

Lie la valeur d'une variable de session à un objet Parameter.

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.SessionParameter

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

public class SessionParameter : Parameter

Le type SessionParameter expose les membres suivants.

  NomDescription
Méthode publiqueSessionParameter()Initialise une nouvelle instance sans nom de la classe SessionParameter.
Méthode protégéeSessionParameter(SessionParameter)Initialise une nouvelle instance de la classe SessionParameter avec les valeurs de l'instance spécifiée par le paramètre original.
Méthode publiqueSessionParameter(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.
Méthode publiqueSessionParameter(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. Ce constructeur est destiné aux types de base de données.
Méthode publiqueSessionParameter(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.
Début

  NomDescription
Propriété publiqueConvertEmptyStringToNullObtient ou définit une valeur indiquant si la valeur à laquelle l'objet Parameter est lié doit être convertie en null si elle est String.Empty. (Hérité de Parameter.)
Propriété publiqueDbTypeObtient ou définit le type de base de données du paramètre. (Hérité de Parameter.)
Propriété publiqueDefaultValueSpé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 est appelée. (Hérité de Parameter.)
Propriété publiqueDirectionIndique 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. (Hérité de Parameter.)
Propriété protégéeIsTrackingViewStateObtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Propriété publiqueNameObtient ou définit le nom du paramètre. (Hérité de Parameter.)
Propriété publiqueSessionFieldObtient ou définit le nom de la variable de session liée au paramètre.
Propriété publiqueSizeObtient ou définit la taille du paramètre. (Hérité de Parameter.)
Propriété publiqueTypeObtient ou définit le type du paramètre. (Hérité de Parameter.)
Propriété protégéeViewStateObtient 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. (Hérité de Parameter.)
Début

  NomDescription
Méthode protégéeCloneRetourne un doublon de l'instance de SessionParameter actuelle. (Substitue Parameter.Clone().)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeEvaluateMet à jour et retourne la valeur de l'objet SessionParameter. (Substitue Parameter.Evaluate(HttpContext, Control).)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetDatabaseTypeObtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle. (Hérité de Parameter.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeLoadViewStateRestaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnParameterChangedAppelle la méthode OnParametersChanged de la collection ParameterCollection qui contient l'objet Parameter. (Hérité de Parameter.)
Méthode protégéeSaveViewStateEnregistre les modifications apportées à l'état d'affichage de l'objet Parameter depuis la publication de la page sur le serveur. (Hérité de Parameter.)
Méthode protégéeSetDirtyMarque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage. (Hérité de Parameter.)
Méthode publiqueToStringConvertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. (Hérité de Parameter.)
Méthode protégéeTrackViewStateAinsi, 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. (Hérité de Parameter.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICloneable.CloneRetourne un doublon de l'instance de Parameter actuelle. (Hérité de Parameter.)
Implémentation d'interface explicitePropriété privéeIStateManager.IsTrackingViewStateInfrastructure. Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Implémentation d'interface expliciteMéthode privéeIStateManager.LoadViewStateInfrastructure. Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Implémentation d'interface expliciteMéthode privéeIStateManager.SaveViewStateInfrastructure. Enregistre les modifications apportées à l'état d'affichage de l'objet Parameter depuis la publication de la page sur le serveur. (Hérité de Parameter.)
Implémentation d'interface expliciteMéthode privéeIStateManager.TrackViewStateInfrastructure. 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. (Hérité de Parameter.)
Début

Un objet SessionParameter est généralement utilisé pour inclure la valeur d'une variable HttpSessionState dans la clause Where d'une requête de base de données. La propriété SessionField identifie la variable de session à partir de laquelle le SessionParameter récupère une valeur.

RemarqueRemarque

Les contrôles qui lient des données à un paramètre à l'aide d'un objet SessionParameter sont susceptibles de lever une exception si la variable de session spécifiée n'est pas définie. Pour éviter cette erreur (lorsque c'est nécessaire), définissez la propriété DefaultValue.

L'exemple ci-dessous explique comment utiliser un objet SessionParameter. L'exemple suppose qu'une autre page a stocké une valeur Employee ID dans une variable de session nommée empid. La page d'exemple utilise la variable de session empid dans la clause Where d'une requête et affiche le résultat de la requête dans un contrôle GridView. Étant donné que la propriété DefaultValue de l'objet SessionParameter a la valeur 5, les données de l'enregistrement qui ont la valeur employeeID 5 restent affichées si aucune variable de session nommée empid n'est définie avant l'exécution de l'exemple.


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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft