Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

CookieParameter, classe

.NET Framework 4

Lie la valeur d'un cookie HTTP côté client à un objet paramètre. Le paramètre peut être utilisé dans une requête ou une commande paramétrée pour sélectionner, filtrer ou mettre à jour des données.

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.CookieParameter

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public class CookieParameter : Parameter

Le type CookieParameter expose les membres suivants.

  Nom Description
Méthode publique CookieParameter() Initialise une nouvelle instance sans nom de la classe CookieParameter.
Méthode protégée CookieParameter(CookieParameter) Initialise une nouvelle instance de la classe CookieParameter avec les valeurs de l'instance spécifiée par le paramètre original.
Méthode publique CookieParameter(String, String) Initialise une nouvelle instance nommée de la classe CookieParameter à l'aide de la chaîne spécifiée pour identifier le cookie HTTP à lier.
Méthode publique CookieParameter(String, DbType, String) Initialise une nouvelle instance de la classe CookieParameter qui présente le nom et le type de base de données spécifiés et qui est liée au cookie HTTP spécifié.
Méthode publique CookieParameter(String, TypeCode, String) Initialise une nouvelle instance nommée et fortement typée de la classe CookieParameter à l'aide de la chaîne spécifiée pour identifier le cookie HTTP à lier.
Début
  Nom Description
Propriété publique 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 String.Empty. (Hérité de Parameter.)
Propriété publique CookieName Obtient ou définit le nom du cookie HTTP lié au paramètre.
Propriété publique DbType Obtient ou définit le type de base de données du paramètre. (Hérité de Parameter.)
Propriété publique 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 est appelée. (Hérité de Parameter.)
Propriété publique 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. (Hérité de Parameter.)
Propriété protégée IsTrackingViewState Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Propriété publique Name Obtient ou définit le nom du paramètre. (Hérité de Parameter.)
Propriété publique Size Obtient ou définit la taille du paramètre. (Hérité de Parameter.)
Propriété publique Type Obtient ou définit le type du paramètre. (Hérité de Parameter.)
Propriété protégée 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. (Hérité de Parameter.)
Début
  Nom Description
Méthode protégée Clone Retourne un doublon de l'instance de CookieParameter actuelle. (Substitue Parameter.Clone().)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Evaluate Met à jour et retourne la valeur de l'objet CookieParameter. (Substitue Parameter.Evaluate(HttpContext, Control).)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetDatabaseType Obtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle. (Hérité de Parameter.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée LoadViewState Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnParameterChanged Appelle la méthode OnParametersChanged de la collection ParameterCollection qui contient l'objet Parameter. (Hérité de Parameter.)
Méthode protégée SaveViewState 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.)
Méthode protégée SetDirty Marque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage. (Hérité de Parameter.)
Méthode publique ToString Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. (Hérité de Parameter.)
Méthode protégée 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. (Hérité de Parameter.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée ICloneable.Clone Retourne un doublon de l'instance de Parameter actuelle. (Hérité de Parameter.)
Implémentation d'interface explicite Propriété privée IStateManager.IsTrackingViewState Infrastructure. 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 explicite Méthode privée IStateManager.LoadViewState Infrastructure. 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 explicite Méthode privée IStateManager.SaveViewState Infrastructure. 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 explicite Méthode privée IStateManager.TrackViewState Infrastructure. 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

Vous pouvez utiliser la classe CookieParameter pour lier la valeur d'un cookie HTTP côté client passée dans le cadre d'une requête HTTP à un paramètre utilisé par les contrôles de source de données ASP.NET.

La classe CookieParameter fournit la propriété CookieName qui identifie le nom de l'objet HttpCookie à lier, outre ceux hérités de la classe Parameter. La classe CookieParameter tente de lier le cookie nommé à chaque appel de la méthode Evaluate.

Remarque importante Important

Les contrôles permettant de lier des données au paramètre peuvent lever une exception si un objet CookieParameter est spécifié mais qu'aucun cookie correspondant n'est passé avec la requête HTTP. De la même façon, ils sont susceptibles de n'afficher aucune donnée si le cookie est passé avec null. Définissez la propriété DefaultValue afin d'éviter ce type de situation lorsque cela est approprié.

L'exemple de code suivant illustre comment utiliser un contrôle SqlDataSource et un objet CookieParameter liés à un cookie HTTP pour afficher les données de la base de données Northwind Traders dans un contrôle GridView.

C#
VB
Copier 

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){
  // These cookies might be added by a login form.
  // They are added here for simplicity.
  if (!IsPostBack) {
      Response.Cookies.Add(new HttpCookie("lname",    "davolio"));
      Response.Cookies.Add(new HttpCookie("loginname","ndavolio"));
      Response.Cookies.Add(new HttpCookie("lastvisit", DateTime.Now.ToString()));
  }
}


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ
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,
Confidentialité