ClientFormsIdentity.AuthenticationType 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 den Authentifizierungstyp ab, der zur Authentifizierung des Benutzers verwendet wird.

public:
 property System::String ^ AuthenticationType { System::String ^ get(); };

public string AuthenticationType { get; }

member this.AuthenticationType : string

Public ReadOnly Property AuthenticationType As String

Eigenschaftswert

String

Der Authentifizierungstyp, der zur Authentifizierung des Benutzers verwendet wird.

Implementiert

AuthenticationType

Beispiele

Der folgende Beispielcode veranschaulicht, wie Sie diese Eigenschaft über einen IIdentity Verweis verwenden, 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 Benutzer sich nicht erneut anmelden müssen, wenn das Authentifizierungscooky abläuft. Andernfalls kann die WebException angeben, 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 feststellen, 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, aber nicht für Clientanwendungsdienste authentifiziert. 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:

Freigeben über