HttpRequest.AnonymousID Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém o identificador anônimo para o usuário, se houver.
public:
property System::String ^ AnonymousID { System::String ^ get(); };
public string AnonymousID { get; }
member this.AnonymousID : string
Public ReadOnly Property AnonymousID As String
Valor da propriedade
Uma cadeia de caracteres que representa o identificador de usuário anônimo atual.
Exemplos
O exemplo a seguir mostra como usar a AnonymousID propriedade manipulando o Creating evento no arquivo Global.asax. Este exemplo tem duas partes:
Um método no arquivo Global.asax que manipula o Creating evento.
Uma página do Web Forms.
A primeira parte do exemplo de código mostra como definir a AnonymousID propriedade manipulando o Creating evento no arquivo Global.asax. O método chamado AnonymousIdentification_Creating
define a AnonymousID propriedade quando uma ID anônima é criada.
void Application_Start(Object sender, EventArgs e)
{
// Initialize user count property
Application["UserCount"] = 0;
}
public void AnonymousIdentification_Creating(Object sender, AnonymousIdentificationEventArgs e)
{
// Change the anonymous id
e.AnonymousID = "mysite.com_Anonymous_User_" + DateTime.Now.Ticks;
// Increment count of unique anonymous users
Application["UserCount"] = Int32.Parse(Application["UserCount"].ToString()) + 1;
}
Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
'Initialize user count property
Application("UserCount") = 0
End Sub
Sub AnonymousIdentification_Creating(ByVal sender As Object, ByVal e As AnonymousIdentificationEventArgs)
' Change the anonymous id
e.AnonymousID = "mysite.com_Anonymous_User_" & DateTime.Now.Ticks
' Increment count of unique anonymous users
Application("UserCount") = Int32.Parse(Application("UserCount").ToString()) + 1
End Sub
A segunda parte do exemplo de código mostra como exibir o novo AnonymousID criado pelo AnonymousIdentification_Creating
manipulador de eventos no exemplo anterior.
<%@ 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)
{
if (Application["UserCount"] != null)
{
lblUserCount.Text = Application["UserCount"].ToString();
lblCurrentUser.Text = Request.AnonymousID;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>AnonymousID Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
Number of users:
<asp:Label ID="lblUserCount" Runat="server"></asp:Label><br />
Current user:
<asp:Label ID="lblCurrentUser" Runat="server"></asp:Label><br />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
If (Application("UserCount") IsNot Nothing) Then
lblUserCount.Text = Application("UserCount").ToString()
lblCurrentUser.Text = Request.AnonymousID
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>AnonymousID Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
Number of users:
<asp:Label ID="lblUserCount" Runat="server"></asp:Label><br />
Current user:
<asp:Label ID="lblCurrentUser" Runat="server"></asp:Label><br />
</div>
</form>
</body>
</html>
Comentários
A AnonymousID propriedade atribui um identificador exclusivo de longa duração a um usuário não autenticado, que pode ser usado para rastrear o usuário ou atribuir propriedades de perfil a esse usuário sem armazenar dados em um Session
objeto . Por padrão, a AnonymousID propriedade é controlada usando um cookie, mas pode ser definida para usar o URI quando o Cookieless atributo na seção de configuração de identificação anônima é definido como o UseUrivalor , UseDeviceProfileou AutoDetect . Você deve limpar explicitamente o cookie se não quiser mais que ele esteja disponível, por exemplo, quando um usuário anônimo é autenticado.
A identificação anônima é usada quando há a necessidade de identificar entidades que não são autenticadas e quando a autorização é necessária. Para obter mais informações, consulte Elemento anonymousIdentification (ASP.NET Settings Schema).