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.

ActiveDirectoryMembershipProvider.FindUsersByName أسلوب

Visual Studio 2010

إرجاع مجموعة من مستخدمين من مخزن بيانات "نشط الدليل" استناداً اسم مستخدم.

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

[DirectoryServicesPermissionAttribute(SecurityAction.Assert, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.InheritanceDemand, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public override MembershipUserCollection FindUsersByName(
	string usernameToMatch,
	int pageIndex,
	int pageSize,
	out int totalRecords
)

المعلمات

usernameToMatch
النوع: System.String
اسم مستخدم أو جزء من اسم مستخدم إلى البحث عنها.
pageIndex
النوع: System.Int32
رقم صفحة النتائج إلى العودة. pageIndexهو zero-based.
pageSize
النوع: System.Int32
الحجم صفحة نتائج إلى العودة.
totalRecords
النوع: System.Int32%
عند إرجاع هذا الأسلوب، يحتوي على الإجمالي رقم من السجلات التي يتم إرجاعها في المجموعة. يتم تمرير هذه المعلمة غير مهيأ.

القيمة المُرجعة

النوع: System.Web.Security.MembershipUserCollection
A MembershipUserCollection containing pageSizeMembershipUser instances beginning at the page specified by pageIndex.

استثناء:شرط
InvalidOperationException

FindUsersByName أسلوب هو استدعاء قبل ActiveDirectoryMembershipProviderمثيل هو تهيئة.

ArgumentException

usernameToMatchهو فارغ أو يتجاوز الحد الأقصى لطول اسم مستخدم (عادة 256 حرفاً).

-أو-

usernameToMatchيحتوي على الفاصلة.

-أو-

pageIndex أقل من 0.

-أو

pageSize أقل من 1.

-أو-

pageSizeضربpageIndex، بالإضافة إلىpageSize، ناقص 1 هو أكبر منMaxValue.

ArgumentNullException

usernameToMatch هو null.

NotSupportedException

TheEnableSearchMethodsproperty هوfalse.

FindUsersByName إرجاع الأسلوب MembershipUserCollectionمثيل التي تحتوي على سجل مستخدم من مخزن بيانات "نشط الدليل" من أجل الجميع أسماء مستخدم التي تتطابق مع userNameToMatchمعلمات. إرجاع السجلات مفروزة أبجدياً حسب اسم مستخدم.

نتائج التي تم إرجاعها بواسطة FindUsersByNameمقيدة هي الطريقة pageIndexو pageSizeمعلمات. pageSizeتعين معلمة الحد الأقصى لعدد MembershipUserمثيلات إلى المرسل في MembershipUserCollection. pageIndexتعين معلمة أي صفحة نتائج للعودة، الموقع تشير إلى 0 (صفر) في الصفحة الأولى.

totalRecordsمعلمة outمعلمة التي تم تعيين إلى إجمالي عدد المستخدمين عضوية مطابقة تم العثور عليها في مخزن بيانات "نشط الدليل". على سبيل المثال، إذا كان هناك 13 مستخدمين لمخزن بيانات المكونة و pageIndexهو القيمة 1 pageSizeMembershipUserCollectionإرجاع ستحتوي السادس من خلال مستخدمي العاشر. totalRecordsهل يمكن تعيين معلمة إلى 13.

يمكنك التحكم ما إذا كنت تريد السماح بالبحث عن المستخدمين، بتعيين EnableSearchMethodsملف باستخدام خاصية في تكوين تطبيق enableSearchMethodsالسمة الخاصة عضوية عنصر (مخطط إعدادات ASP.NET)العنصر. إعداد EnableSearchMethodsالقيمة خاصية إلى falseيؤدي FindUsersByNameأسلوب طرح NotSupportedException‏‏ استثناء.

موفر يستخدم بحث الشجرة فرعية بدءاً من يؤشر البحث المحدد في سلسلة الاتصال. راجع ActiveDirectoryMembershipProviderموضوع فئة للحصول على مزيد من المعلومات حول سلاسل اتصال.

من المستحسن أن عدم تمكين يتم الآن البحث في أنظمة الإنتاج إلى أن أكدت تشغيل أن إصدار استعلامات يتم الآن البحث بواسطة ActiveDirectoryMembershipProviderلا يؤثر بشكل سلبي يؤثر تشغيل الفئة الأداء خادم الدليل's. منذ ActiveDirectoryMembershipProviderالفئة هو مصمم لبيئة ويب عديم الحالة، فإنه هو غير قادر على استخدام أمثلية الأداء الخاصة بترحيل الصفحات المعروضة بواسطة الأساسية System.DirectoryServicesنقطة الوصول هو. وهذا يعني أن العمليات ترحيل الصفحات أثناء العمليات البحث مقابل الدلائل قطر أيمن متوسط مكلفة جداً ويجب تجنب. العمليات بحث دائماً تصدر مقابل الخادم الدليل المكون في سلسلة الاتصال، أو الخادم محددة تلقائياً في حالة من سلسلة اتصال الإشارة في مجال. موفر لا يستخدم نشرة مصورة عمومي لأساليب بحث الخاصة به.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

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

.NET Framework

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