عنصر roleManager (مخطط إعدادات ASP.NET)
تكوين تطبيق لإدارة الدور.
يعتبر هذا العنصر جديدا في NET Framework. الإصدار 2.0.
عنصر تكوين (مخطط إعدادات عام)
النظام.ويب عنصر (مخطط إعدادات ASP.NET)
عنصر roleManager (مخطط إعدادات ASP.NET)
<roleManager
cacheRolesInCookie="true|false"
cookieName="name"
cookiePath="/"
cookieProtection="All|Encryption|Validation|None"
cookieRequireSSL="true|false "
cookieSlidingExpiration="true|false "
cookieTimeout="number of minutes"
createPersistentCookie="true|false"
defaultProvider="provider name"
domain="cookie domain">
enabled="true|false"
maxCachedResults="maximum number of role names cached"
<providers>...</providers>
</roleManager>
السمات والعناصر
تصف المقاطع التالية سمات عناصر فرعية وعناصر أصل لهذا المقطع.
السمات
السمة |
الوصف |
---|---|
cacheRolesInCookie |
سمة Boolean اختيارية. تحديد أنه عند التحقق من صحة أن المستخدم بدور مخصوص, يتم تدقيق ملف تعريف الارتباط قبل استخدام موفر الدور للتحقق من قائمة الأدوار في مصدر البيانات. إذا كانت true، قائمة أسماء الأدوار في ملف تعريف ارتباط تم تخزينها تخزيناً مؤقتاً للمستخدم الحالي ؛ وإلا, false. يكون الإعداد الافتراضي هو false. |
cookieName |
سمة String اختيارية. تعيين اسم ملف تعريف ارتباط التي تم فيه تخزين أسماء الادوار. يكون الإعداد الافتراضي هو ".ASPXROLES". |
cookiePath |
سمة String اختيارية. مسار ملف تعريف ارتباط أسماء الدور. يكون الإعداد الافتراضي هو "/". |
cookieProtection |
سمة CookieProtection اختيارية. تعيين إحدى القيم في تعداد CookieProtection . القيمة الافتراضية هي All. |
cookieRequireSSL |
سمة Boolean اختيارية. تحديد ما إذا كان ملف تعريف ارتباط أسماء الأدوار يتطلب إرسال SSL إلى الخادم. في حالة تعيين true، ملفات تعريف ارتباط أسماء الادوار تتطلب ارسال ملفات SSL إلى الخادم. يكون الإعداد الافتراضي هو false. |
cookieSlidingExpiration |
سمة Boolean اختيارية. تحديد ما إذا كان سيتم إعادة تعيين تاريخ انتهاء صلاحية ملف تعريف ارتباط أسماء الدور بشكل دوري. في حالة تعيين true, سيتم أولا تعيين انتهاء صلاحية ملف تعريف الارتباط في على الوقت والتاريخ الحاليين بالإضافة إلى CookieTimeoutالقيمة بالدقائق. بينما يستمر المستخدم باستخدام تطبيق ASP.NET بنشاط، يتم تحديث تاريخ انتهاء الصلاحية ملف تعريف الارتباط تلقائيًا، إذا كان هناك أقل من نصف CookieTimeoutالقيمة المتبقية. لمزيد من المعلومات، راجع Expires. يكون الإعداد الافتراضي هو true. |
cookieTimeout |
سمة Int32 اختيارية. عدد الدقائق قبل انتهاء صلاحية أسماء دور ملفات تعريف الارتباط. الافتراضية هي "30" دقائق. |
createPersistentCookie |
سمة Boolean اختيارية. تحديد ما إذا كانت ملفات تعريف ارتباط أسماء الدور هي جلسة عمل; هذا يعني أن ملف تعريف الارتباط يكون مفقودا عند إغلاق المستعرض. عند تعيين true، أسماء دور ملف تعريف الارتباط هو تعريف ارتباط دائم متوفر عبر العديد من جلسات عمل المستعرض. CookieTimeout, تاريخ انتهاء صلاحية ملف تعريف الارتباط الدائم معينة على الوقت والتاريخ الحاليين بالإضافة إلى القيمة بالدقائق يكون الإعداد الافتراضي هو false. |
defaultProvider |
سمة String اختيارية. اسم موفر الأدوار الافتراضي. لمزيد من المعلومات، راجع Provider. يكون الإعداد الافتراضي هو "AspNetSqlRoleProvider". |
domain |
سمة String اختيارية. تعيّن Domainقيمة ملف تعريف ارتباط أسماء الأداور. الافتراضي هو HttpCookieالخاصية الافتراضية، وهو عبارة عن سلسلة فارغة (""). |
enabled |
سمة Boolean اختيارية. تحديد ما إذا كان سيتم تمكين إدارة الدور. عند تعيين true، تمكين إدارة الدور. الافتراضي falseفي الملف Machine.config. |
maxCachedResults |
سمة Int32 اختيارية. تعيّن الحد الأقصى من عدد أسماء الأدوار التي تم تخزينها مؤقتاً في ملف تعريف ارتباط الأدوار. يكون الإعداد الافتراضي هو 25. |
سمات متوارثة |
سمات إختيارية. سمات توريث الكل sectionالعناصر. لمزيد من المعلومات، راجع سمات عامة موروثة من عناصر القسم. |
العناصر التابعة
العنصر |
الوصف |
---|---|
providers |
عنصر اختياري. تعريف مجموعة من موفري الأدوار لإدارة الدور. |
العناصر الأصلية
العنصر |
الوصف |
---|---|
configuration |
تحديد جذر العنصر المطلوب في كل ملف تكوين مستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات NET Framework. |
system.web |
تحدّد جذر العنصر لمقطع التكوين ASP.NET . |
ملاحظات
roleManagerاعنصر يقوم بتكوين تطبيق إدارة الأدوار.
لمزيد من المعلومات حول الوصول و تعديل قيم التكوين roleManagerلعنصر في تعليمة التطبيق ، راجع RoleManagerSection.
التكوين الافتراضي
The following default roleManager element is not explicitly configured in the Machine.config file or in the root Web.config file. ومع ذلك، هو التكوين الافنراضي التي يتم إرجاعها من قبل التطبيق. يتم تكوين الموفرين بوضوح في الملف Machine.config.
<roleManager
enabled="false"
cacheRolesInCookie="false"
cookieName=".ASPXROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All"
defaultProvider="AspNetSqlRoleProvider"
createPersistentCookie="false"
maxCachedResults="25">
<providers>
<clear />
<add
connectionStringName="LocalSqlServer"
applicationName="/"
name="AspNetSqlRoleProvider"
type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add
applicationName="/"
name="AspNetWindowsTokenRoleProvider"
type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
</roleManager>
مثال
يظهر المثال تعليمات برمجية التالي كيفية تكوين أحد تطبيقات ASP.NET لاستخدام SqlRoleProviderموفر لتخزين واستردادها معلومات يحلل.
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<add
name="SqlProvider"
type="System.Web.Security.SqlRoleProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication" />
</providers>
</roleManager>
</system.web>
</configuration>
معلومات العنصر
معالج مقطع التكوين |
|
عضو التكوين |
|
مواقع للتكوين |
Machine.config مستوى جذر ويب.config مستوى تطبيق ويب.config |
المتطلبات |
Microsoft Internet Information Services (IIS) الإصدار 5.0 أو 5.1 أو 6.0. .NET Framework، الإصدار 2.0 Microsoft Visual Studio 2003 أو Visual Studio 2005 |
راجع أيضًا:
المهام
كيفية: تكوين دلائل معينة باستخدام إعدادات الموقع
كيفية: تأمين إعدادات التكوين ASP.NET
المرجع
النظام.ويب عنصر (مخطط إعدادات ASP.NET)
عنصر موفري roleManager (مخطط إعدادات ASP.NET)