ClientFormsIdentity.IsAuthenticated Eigenschaft

Referenz

Definition

Namespace:: System.Web.ClientServices

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob der Benutzer authentifiziert wurde.

public:
 property bool IsAuthenticated { bool get(); };

public bool IsAuthenticated { get; }

member this.IsAuthenticated : bool

Public ReadOnly Property IsAuthenticated As Boolean

Eigenschaftswert

Boolean

true, wenn der Benutzer authentifiziert wurde, andernfalls false.

Implementiert

IsAuthenticated

Beispiele

Der folgende Beispielcode veranschaulicht, wie diese Eigenschaft mithilfe eines IIdentity Verweises verwendet wird, um zu bestimmen, ob ein Benutzer derzeit für Clientanwendungsdienste authentifiziert ist. In diesem Beispiel wird davon ausgegangen, dass sich die Anwendung in der Standardkonfiguration befindet, in der sich Benutzer nicht erneut anmelden müssen, wenn das Authentifizierungscookies abläuft. Andernfalls weist möglicherweise darauf WebException hin, dass die Benutzeranmeldung abgelaufen ist.

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);
    }
}

Private Sub SaveSettings()

    Dim identity As System.Security.Principal.IIdentity = _
        System.Threading.Thread.CurrentPrincipal.Identity

    ' Return if the user is not authenticated.
    If identity Is Nothing OrElse Not identity.IsAuthenticated Then Return

    ' Return if the authentication type is not "ClientForms". This indicates
    ' that the user is not authenticated for client application services.
    If Not identity.AuthenticationType.Equals("ClientForms") Then Return

    Try

        My.Settings.Save()

    Catch ex As 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)

    End Try

End Sub

Hinweise

In der Regel greifen Sie auf ein ClientFormsIdentity Objekt als IIdentity Verweis zu, um eine direkte Abhängigkeit von dieser Klasse zu vermeiden. Sie können bestimmen, ob ein Benutzer authentifiziert ist, indem Sie die IIdentity.IsAuthenticated -Eigenschaft der Identität überprüfen. Der Benutzer wird jedoch möglicherweise für Windows authentifiziert, aber nicht für Clientanwendungsdienste. Um zu bestimmen, ob der Benutzer für Clientanwendungsdienste authentifiziert ist, sollten Sie auch bestätigen, dass der IIdentity.AuthenticationType Eigenschaftswert "ClientForms" lautet. Weitere Informationen finden Sie in der ClientFormsIdentity Klassenübersicht.

Gilt für: