Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
CookieParameter, classe
Collapse the table of content
Expand the table of content
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

CookieParameter, classe

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)

public class CookieParameter : Parameter

Le type CookieParameter expose les membres suivants.

  NomDescription
Méthode publiqueCookieParameter()Initialise une nouvelle instance sans nom de la classe CookieParameter.
Méthode protégéeCookieParameter(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 publiqueCookieParameter(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 publiqueCookieParameter(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 publiqueCookieParameter(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

  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é publiqueCookieNameObtient ou définit le nom du cookie HTTP lié au paramètre.
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é 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é publiqueValidateInputObtient ou définit une valeur qui spécifie si la valeur du paramètre est validée.
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 CookieParameter 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 CookieParameter. (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

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 importanteImportant

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.


<%@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.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
Afficher:
© 2015 Microsoft