SessionIDManager.CreateSessionID(HttpContext) Méthode

Définition

Espace de noms:

System.Web.SessionState

Assembly:

System.Web.dll

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 par des CreateSessionID méthodes qui fournissent et valident un Guid en tant que 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 Settings 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 manière aléatoire encodé dans une chaîne de 24 caractères composée de caractères minuscules de a à 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 CreateSessionID(HttpContext) méthodes et Validate(String) par vos propres implémentations personnalisées. Si votre ID de session personnalisé ne respecte pas les contraintes de caractères 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 s’assure que votre identificateur de session personnalisé est encodé dans l’URL dans la réponse HTTP et l’URL décodée à partir de la requête HTTP à l’aide Encode(String) des méthodes et Decode(String) , respectivement.

Voir aussi

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