AnonymousIdentificationModule Class

.NET Framework (current version)

Other Versions

Manages anonymous identifiers for the ASP.NET application.

Namespace: System.Web.Security
Assembly: System.Web (in System.Web.dll)

Inheritance Hierarchy

System.Object
System.Web.Security.AnonymousIdentificationModule

Syntax

C++

public sealed class AnonymousIdentificationModule : IHttpModule

Constructors

	Name	Description
	AnonymousIdentificationModule()	Creates an instance of the AnonymousIdentificationModule class.

Properties

	Name	Description
	Enabled	Gets a value indicating whether anonymous identification is enabled for the ASP.NET application.

Methods

	Name	Description
	ClearAnonymousIdentifier()	Clears the anonymous cookie or identifier associated with a session.
	Dispose()	Releases all resources, other than memory, used by the AnonymousIdentificationModule.
	Equals(Object)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	Init(HttpApplication)	Initializes the AnonymousIdentificationModule object.
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Events

	Name	Description
	Creating	Occurs when a new anonymous identifier is created.

The AnonymousIdentificationModule class creates and manages anonymous identifiers for an ASP.NET application. Anonymous identifiers are used by features that support anonymous identification such as the ASP.NET System.Web.Profile.

The AnonymousIdentificationModule exposes a Creating event that enables you to set the anonymous identifier to a custom value. If you do not specify a custom anonymous identifier value, a Guid is used.

The Creating event is accessed by specifying a subroutine named AnonymousIdentification_Creating in the Global.asax file for your ASP.NET application.

The AnonymousIdentificationModule is only used when anonymous identification is Enabled by setting the enabled attribute of the configuration element to true.

Note
Anonymous identification is independent of any type of ASP.NET authentication.

Examples

The following code example shows a Web.config file for an application that enables anonymous identification.

<configuration>
  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>

    <anonymousIdentification enabled="true" />

    <profile defaultProvider="AspNetSqlProvider">
      <properties>
        <add name="ZipCode" allowAnonymous="true" />
        <add name="CityAndState" allowAnonymous="true" />
        <add name="StockSymbols" type="System.Collections.ArrayList" 
          allowAnonymous="true" />
      </properties>
    </profile>
  </system.web>
</configuration>

Version Information

.NET Framework
Available since 2.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.