SessionIDManager.CreateSessionID(HttpContext) Méthode

Référence

Définition

Espace de noms:: System.Web.SessionState

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un identificateur de session unique pour la session.

public:
 virtual System::String ^ CreateSessionID(System::Web::HttpContext ^ context);

public virtual string CreateSessionID (System.Web.HttpContext context);

abstract member CreateSessionID : System.Web.HttpContext -> string
override this.CreateSessionID : System.Web.HttpContext -> string

Public Overridable Function CreateSessionID (context As HttpContext) As String

Paramètres

context: HttpContext

Objet HttpContext actuel faisant référence aux objets serveurs utilisés pour traiter les demandes HTTP (par exemple, les propriétés Request et Response).

Retours

String

Identificateur de session unique.

Implémente

CreateSessionID(HttpContext)

Exemples

L’exemple de code suivant montre une classe qui hérite de la SessionIDManager classe et remplace les méthodes et Validate les CreateSessionID méthodes avec des méthodes qui fournissent et valident un Guid comme le SessionID.

using System;
using System.Configuration;
using System.Web.Configuration;
using System.Web;
using System.Web.SessionState;

namespace Samples.AspNet.Session
{

  public class GuidSessionIDManager : SessionIDManager
  {

    public override string CreateSessionID(HttpContext context)
    {
      return Guid.NewGuid().ToString();
    }

    public override bool Validate(string id)
    {
      try
      {
        Guid testGuid = new Guid(id);

        if (id == testGuid.ToString())
          return true;
      }
      catch
      {
      }

      return false;
    }
  }
}

Imports System.Configuration
Imports System.Web.Configuration
Imports System.Web
Imports System.Web.SessionState


Namespace Samples.AspNet.Session

  Public Class GuidSessionIDManager
    Inherits SessionIDManager

    Public Overrides Function CreateSessionID(context As HttpContext) As String
      Return Guid.NewGuid().ToString()
    End Function

    Public Overrides Function Validate(id As String) As Boolean
      Try
        Dim testGuid As Guid = New Guid(id)

        If id = testGuid.ToString() Then _
          Return True
      Catch
      
      End Try

      Return False
    End Function

  End Class

End Namespace

Pour utiliser la classe personnalisée illustrée dans cet exemple, configurez l’attribut sessionIDManagerType de l’élément sessionState Element (ASP.NET Paramètres Schema), comme illustré dans l’exemple suivant.

<sessionState
  Mode="InProc"
  stateConnectionString="tcp=127.0.0.1:42424"
  stateNetworkTimeout="10"
  sqlConnectionString="data source=127.0.0.1;Integrated Security=SSPI"
  sqlCommandTimeout="30"
  customProvider=""
  cookieless="false"
  regenerateExpiredSessionId="false"
  timeout="20"
  sessionIDManagerType="Your.ID.Manager.Type,
    CustomAssemblyNameInBinFolder"
/>

Remarques

Cette méthode n’est pas destinée à être appelée à partir du code d’application.

La CreateSessionID méthode retourne un identificateur de session unique qui est un nombre généré de façon aléatoire en une chaîne de 24 caractères composée de caractères minuscules d’un à z et de nombres compris entre 0 et 5.

Notes pour les héritiers

Vous pouvez fournir un identificateur de session personnalisé à utiliser par ASP.NET état de session en créant une classe qui hérite de la SessionIDManager classe et en remplaçant les méthodes et Validate(String) les CreateSessionID(HttpContext) méthodes avec vos propres implémentations personnalisées. Si votre ID de session personnalisé ne répond pas aux contraintes de caractère appliquées par l’implémentation par défaut de la Validate(String) méthode, vous devez remplacer la méthode pour fournir la Validate(String) validation de votre identificateur de session personnalisé. Dans ce cas, la SessionIDManager classe garantit que votre identificateur de session personnalisé est codé dans la réponse HTTP et l’URL décodées à partir de la requête HTTP à l’aide des méthodes et Decode(String) des Encode(String) méthodes, respectivement.

S’applique à

Voir aussi

Vue d'ensemble de l'état de session ASP.NET

Partager via