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.

SqlPersonalizationProvider.GetCountOfState أسلوب

Visual Studio 2010

إرجاع عدد عدد صفوف في مخزن بيانات الأساسية الموجودة ل المعين scopeمعلمة.

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

public override int GetCountOfState(
	PersonalizationScope scope,
	PersonalizationStateQuery query
)

المعلمات

scope
النوع: System.Web.UI.WebControls.WebParts.PersonalizationScope
A PersonalizationScope indicating the إضفاء طابع شخصي معلومات إلى be queried. لا يمكن أن تكون هذه القيمة null.
query
النوع: System.Web.UI.WebControls.WebParts.PersonalizationStateQuery
A PersonalizationStateQuery containing a استعلام. يمكن أن تكون هذه القيمة null.

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

النوع: System.Int32
عدد صفوف الموجودة في مخزن بيانات الأساسية الموجودة ل المعين scopeمعلمة.

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

PathToMatch هو non-null و هو an فارغ سلسلة ("") بعد trimming.

-أو-

The الطول of PathToMatch هو أكبر من 256 حرف/ حروف when the القيمة هو non-null.

-أو-

UsernameToMatch هو non-null و هو an فارغ سلسلة بعد trimming.

-أو-

The الطول of UsernameToMatch هو أكبر من 256 حرف/ حروف when the القيمة هو non-null.

ArgumentOutOfRangeException

scopeالمحدد هو غير صحيح تتراوح PersonalizationScopeالتعداد.

أحرف البدل استعلام يقوم بتمرير هذه الطريقة إلى sإلىre بيانات المصدر. اعتماد أحرف البدل هو حاليا يعتمد تشغيل كيفية معالجة كل موفر أحرف مثل asterهوk (*) أو الرمز النسبة المئوية (%) أو تسطير أسفل السطر (_).

وتكون عادة لمخازن بيانات المتوافق مع SQL، يمكنك إجراء بحث حرف بدل تشغيل مسار جزئي باستخدام حرف البدل الظهور في البداية أو النهاية منتصف نص سلسلة البحث في PathToMatchخاصية. على سبيل المثال، للعثور على كافة المسارات التي يبدأ مع "~/approot", PathToMatchقد يتم تعيين خاصية إلى "~/approot%".

كذلك، بحث حرف بدل حول جزئيا اسم المستخدم أن يكون حرف بدل تظهر عند أي يؤشر في سلسلة نصية في UsernameToMatchخاصية. على سبيل المثال، إلى البحث عن الجميع أسماء المستخدمين التي يتم تشغيلها باستخدام "احمد", UsernameToMatchمعلمة تبدو مثل "احمد%".

يلي استعلام يطبق قيود:

  • إذا كان فقط scopeالمتوفر، و queryهو nullأو الجميع الخصائص تشغيل queryبإرجاع أي nullأو قيم الافتراضية، ثم الجميع السجلات التي تتطابق مع المشار إليه في scopeيتم إرجاع معلمة.

  • إذا PathToMatchخاصية هو غير null، السجلات التي تم إرجاعها هي أيضا المصفاة المسارات استناداً إلى المطابقة PathToMatchالقيمة خاصية.

  • إذا UsernameToMatchهو لا null، السجلات التي تم إرجاعها هي أيضا أسماء مستخدمين استناداً إلى المصفاة التي تطابق UsernameToMatchالقيمة خاصية.

  • إذا UserInactiveSinceDateكانت خاصية لا يساوي MaxValue، ثم تتم أيضا تصفية السجلات التي يتم إرجاعها لإرجاع تلك السجلات فقط مقترنة غير نشط المستخدمين. comparهوon يتضمن السجلات الموقع LastActivityDateخاصية هو أصغر من أو يساوي UserInactiveSinceDateخاصية.

لاحظ أن هذا أسلوب لا تتحقق من تركيبات من معلمات الاستعلام. على سبيل المثال، يمكن للتعليمات البرمجية طلب عدد السجلات في الولاية مقترنة مع مستخدمين غير نشطين في نطاق المشترك. لأن هناك هو لا يوجد مفهوم للتخصيصات غير نشط، سيكون العدد الذي يتم إرجاعه صفر.

تركيبات معلمة التي لديها القدرة على إلى إرجاع تضمين مجموعة غير فارغ:

نظام التشغيل 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
إظهار: