ClientFormsIdentity.IsAuthenticated Property

 

Gets a value indicating whether the user has been authenticated.

Namespace:   System.Web.ClientServices
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public bool IsAuthenticated { get; }

Property Value

Type: System.Boolean

true if the user has been authenticated; otherwise, false.

You will typically access a ClientFormsIdentity object as an IIdentity reference to avoid a direct dependency on this class. You can determine whether a user is authenticated by checking the IIdentity.IsAuthenticated property of the identity. However, the user may be authenticated for Windows, but not for client application services. To determine whether the user is authenticated for client application services, you should also confirm that the IIdentity.AuthenticationType property value is "ClientForms". For more information, see the ClientFormsIdentity class overview.

The following example code demonstrates how to use this property through an IIdentity reference to determine whether a user is currently authenticated for client application services. This example assumes that the application is in the default configuration where users are not required to log in again when the authentication cookie expires. Otherwise, the WebException might indicate that the user login has expired. For more information, see How to: Configure Client Application Services.

private void SaveSettings()
{
    System.Security.Principal.IIdentity identity = 
        System.Threading.Thread.CurrentPrincipal.Identity;

    // Return if the user is not authenticated.
    if (identity == null || !identity.IsAuthenticated) return;

    // Return if the authentication type is not "ClientForms". 
    // This indicates that the user is not authenticated for 
    // client application services.
    if (!identity.AuthenticationType.Equals("ClientForms")) return;

    try
    {
        Properties.Settings.Default.Save();
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the Web settings service. " +
            "Settings were not saved on the remote service.", 
            "Not logged in", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
}

.NET Framework
Available since 3.5
Return to top
Show: