This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

ClientFormsIdentity الفئة

Visual Studio 2010

يمثل هوية مستخدم مصادقة عميل الخدمات تطبيق بواسطة استخدام نماذج المصادقة.

مساحة الاسم:  System.Web.ClientServices
التجميع:  System.Web.Extensions (في System.Web.Extensions.dll)

public class ClientFormsIdentity : IIdentity, 
	IDisposable

ميزة الخدمات تطبيق العميل يستخدم هذه الفئة إلى تمثل مستخدم مصادق. When you configure your application to use client application services and forms authentication, you can authenticate a user by calling the static Membership.ValidateUser method. After authentication, you can retrieve a reference to the current ClientFormsIdentity instance through the Identity property of the IPrincipal retrieved through the static Thread.CurrentPrincipal property. لمزيد من المعلومات، راجع تطبيق العميل الخدمات.

يتم عادة الوصول إلى ClientFormsIdentityكائن IIdentityمرجع لتجنب تبعية مباشر تشغيل هذه فئة. يمكنك تحديد ما إذا كان المستخدم هو مصادق عليه بواسطة التحقق من IIdentity.IsAuthenticatedخاصية للهوية. ومع ذلك، قد يتم مصادقة مستخدم ل Windows، ولكن ليس من أجل تطبيق العميل الخدمات. إلى تحديد ما إذا كانت مصادقة مستخدم لخدمات تطبيق العميل، يجب عليك أيضا التأكد من أن IIdentity.AuthenticationTypeهو القيمة خاصية "ClientForms".

يجب استخدام صريح ClientFormsIdentityمرجع للاتصال RevalidateUserالأسلوب، الذي هو غير المعرفة من قبل IIdentityالواجهة.

المثال التالي تعليمات برمجية يوضح كيفية استخدام هذه الفئة بصمت revalidate مستخدم عند ترك تطبيق في الولاية عدم الاتصال. في هذا المثال، CheckedChangedمعالج الأحداث بتحديث حالة غير متصل إلى تطابق القيمة خانة اختيار. إذا كان مستخدم يقوم بتعيين تطبيق إلى الولاية الاتصال، حدث يحاول معالج revalidate مستخدم بواسطة استدعاء RevalidateUserالأسلوب. ومع ذلك، إذا كان الخادم مصادقة هو غير متوفر، معالج الأحداث بإرجاع تطبيق إلى الولاية عدم الاتصال.

ملاحظةملاحظة

RevalidateUser أسلوب هو وذلك فقط. لأنه ليس له القيمة إرجاع، لا تشير إلى ما إذا كان فشل revalidation. يمكن أن تفشل revalidation، ل مثال، إذا قمت بتغيير بيانات اعتماد مستخدم تشغيل الملقم. في هذه الحالة، قد تحتاج إلى تضمين تعليمات برمجية التحقق التي بوضوح من المستخدمين بعد فشل نداء الخدمة. ل المزيد من المعلومات، راجع قسم "الوصول إلى إعدادات ويب" في الإرشادات التفصيلية: استخدام الخدمات تطبيق العميل.


private void workOfflineCheckBox_CheckedChanged(
    object sender, EventArgs e)
{
    ConnectivityStatus.IsOffline = workOfflineCheckBox.Checked;
    if (!ConnectivityStatus.IsOffline)
    {
        try
        {
            // Silently re-validate the user.
            ((ClientFormsIdentity)
                System.Threading.Thread.CurrentPrincipal.Identity)
                .RevalidateUser();

            // If any settings have been changed locally, save the new
            // new values to the Web settings service.
            SaveSettings();

            // If any settings have not been changed locally, check 
            // the Web settings service for updates. 
            Properties.Settings.Default.Reload();
        }
        catch (System.Net.WebException)
        {
            MessageBox.Show(
                "Unable to access the authentication service. " +
                Environment.NewLine + "Staying in offline mode.",
                "Warning", MessageBoxButtons.OK, 
                MessageBoxIcon.Warning);
            workOfflineCheckBox.Checked = true;
        }
    }
}


System.Object
  System.Web.ClientServices.ClientFormsIdentity

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5
إظهار: