كيفية القيام بما يلي: تكوين عميل الخدمات تطبيق

This topic describes how to use the Visual Studio Project Designer to enable and configure client application services. يمكنك استخدام تطبيق العميل الخدمات للتحقق من صحة المستخدمين واسترداد أدوار المستخدمين والإعدادات من موجودة Microsoft Ajaxتطبيق الخدمة. بعد تكوين، يمكن الوصول إلى الخدمات الممكنة في تعليمات برمجية للتطبيق الخاص بك كـ الموصوفة في نظرة عامة حول الخدمات تطبيق العميل. للحصول على مزيد من المعلومات حول Microsoft Ajaxخدمات التطبيقات، راجع نظرة عامة حول خدمات تطبيقات ASP.NET.

يمكنك تمكين وتكوين الخدمات تطبيق العميل صفحة الخدمات مصمم المشروع . الصفحة Services بتحديث قيم في App.config مشروع الخاص بك ملف. للوصول إلى مصمم مشروع ، باستخدام الأمر خصائص من قائمة مشروع. للحصول على مزيد من المعلومات حول صفحة الخدمات ، راجع صفحة الخدمات، مصمم المشروع. للحصول على مزيد من المعلومات حول مشروع "مصمم"، راجع مقدمة إلى مصمم المشروع.

يصف الإجراء التالي كيفية إلى إجراء تكوين الأساسي لخدمات تطبيق العميل. المتقدمة بتكوين الخيارات الموضحة في المقاطع لاحقاً.

إلى تكوين الخدمات تطبيق العميل

1. في من Soluti تشغيل مستكشف، تحديد عقدة مشروع ثم تشغيل انقر قائمة مشروع خصائص.

   يظهر Project Designer .

2. انقر فوق علامة التبويب خدمات. تظهر الصفحة الخدمات، كما هو مبين في التوضيح التالي.

   

3. في الصفحة الخدمات ، تحديد تمكين تطبيق العميل خدمات .

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

   ملاحظة

   If you تحديد استخدام مصادقة Windows, العميل تطبيق الخدمات will automatically be configured إلى استخدم a SQL Server Compact Edition الإصدار 3.5 قاعدة بيانات. هذا هو المشار إليه في الإعدادات المتقدمة الخاصة بخدمات صندوق حوار كما هو موضح في المقطع التالي. إذا حددت استخدام مصادقة النماذج ثم غير سيتم مسح إعداد استخدام سلسلة اتصال مخصصة تلقائياً. This could النتيجة في أخطاء if the SQL Server Compact 3.5 قاعدة بيانات has already been generated for استخدم مع مصادقة Windows. إلى fix these أخطاء, مسح the استخدم مخصص اتصال سلسلة إعداد في the متقدم إعدادات for الخدمات حوار صندوق.

5. إذا قمت بتحديد استخدام مصادقة النماذج ، في المربع موقع خدمة مصادقة، حدد عنوان URL الخاص بمضيف الخدمة، متضمناً اسم الملف. The مصمم will automatically append the قياسي اسم الملف (Authentication_JSON_AppService.axd) when it writes the القيمة إلى the ملف تكوين.

6. Optionally, if you محدد استخدم Forms مصادقة, you can specify a القيمة في the بيانات اعتماد موفر صندوق. The بيانات اعتماد موفر must implement the IClientFormsAuthenticationCredentialsProvider واجهة. بواسطة باستخدام موفر بيانات اعتماد، يمكنك فصل واجهة مستخدم تسجيل الدخول الخاص بك من تعليمات برمجية تطبيق الآخر. يمكنك ذلك من إنشاء تسجيل دخول مفرد صندوق حوار للاستخدام في تطبيقات متعددة. لمزيد من المعلومات، راجع كيفية القيام بما يلي: قم بتطبيق المستخدم تسجيل الدخول إلى و تسجيل الخروج باستخدام الخدمات تطبيق العميل.

   إذا قمت بتحديد موفر بيانات اعتماد، يجب عليك تحديد به كـ sembly كـ-اسم نوع المؤهل. للمزيد من المعلومات، راجع Type.AssemblyQualifiedName وأسماء التجميع. في النموذج الأبسط, يكون اسم نوع التجميع المؤهل مشابه للمثال التالي:

   MyNamespace.MyLoginClass, MyAssembly
   

7. في الأدوار خدمة الموقع و خدمة ويب إعدادات الموقع مربعات نص ، قم بتحديد الموقع الخدمة لكل خدمة، بما في ذلك اسم الملف. auإلىmatically إلى المصمم إلحاق أسماء الملفات القياسية (Role_JSON_AppService.axd و Profile_JSON_AppService.axd) عندما يكتب فيها القيمة إلى ملف تكوين.

8. بشكل اختياري، انقر فوق خيارات متقدمة إلى تعديل الإعدادات المتقدمة، مثل سلوك تخزين مؤقت المحلي. للحصول على المزيد من المعلومات، راجع الإجراء التالي.

متقدم تكوين

تصف الإجراءات التالية كيفية إلى تكوين الخدمات تطبيق العميل لسيناريو أقل شيوعاً. على سبيل المثال، يمكنك استخدام خيارات تكوين هذه للتطبيقات التي تم نشرها في الأماكن العامة، أو إلى استخدام بيانات مشفرة SQL Server Compact Edition الإصدار 3.5قاعدة بيانات كذاكرة التخزين المؤقت للبيانات المحلية.

إلى تكوين إعدادات متقدمة لخدمات تطبيق العميل

1. صفحة الخدمات مصمم المشروع ، انقر فوق خيارات متقدمة.

   الإعدادات المتقدمة الخاصة بالخدمات صندوق حوار يظهر، كما هو مبين في التوضيح التالي. للحصول على مزيد من المعلومات حول هذا الموضوع مربع حوار، راجع إعدادات متقدمة لمربع حوار الخدمات.

   

2. حدد أو امسح حفظ تجزئة كلمة المرور محلياً إلى قم بتمكين تسجيل الدخول دون اتصال . عند تحديد هذا خيار، سوف يتم التخزين المؤقت شكل مشفر مستخدم's كلمة المرور محلياً. Th هو هو مفيدة إذا قمت بتطبيق الوضع غير متصل للتطبيق الخاص بك. مع محدد هذا خيار، يمكنك التحقق من صحة المستخدمين حتى عند IsOfflineخاصية تم التعيين إلى true. ل المزيد على معلومات حول الوضع غير متصل، راجع كيفية القيام بما يلي: العمل بدون اتصال مع الخدمات تطبيق العميل.

3. حدد أو امسح يقوم المستخدمون إلى بتسجيل الدخول مرة أخرى عند انتهاء صلاحية ملف تعريف ارتباط للخادم . ملف تعريف ارتباط المصادقة هو تكوين الخدمة بعيد، ويشير إلى مدة ستظل نشطة تسجيل الدخول الخاص بالمستخدم. للحصول على مزيد من المعلومات حول إلى قم بتكوين ملف تعريف الارتباط، راجع timeoutسمة في نماذج عنصر للمصادقة (مخطط إعدادات ASP.NET).

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

   إذا قمت بإلغاء تحديد هذا خيار و محاولة للوصول إلى الخدمات بعيد بعد انتهاء مدة صلاحية ملف تعريف ارتباط مصادقة، سوف يكون revalidated المستخدمين تلقائياً.

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

   يصل موفر الدور إلى قيم الدور المؤقتا أو خدمة الأدوار عند استدعاء IsInRoleالأسلوب. لإعادة تعيين ذاكرة تخزين مؤقت وفرض هذا الأسلوب للوصول إلى الخدمة البعيدة برمجياً، استدعاء ResetCacheالأسلوب.

5. تحديد أو امسح استخدم سلسلة اتصال مخصصة . للحصول على المزيد من المعلومات، راجع الإجراء التالي.

لتكوين الخدمات تطبيق العميل إلى استخدم قاعدة بيانات لذاكرة التخزين المؤقت المحلية

1. صفحة الخدمات مصمم المشروع ، انقر فوق خيارات متقدمة.

   يظهر صندوق الحوار إعدادات متقدمة للخدمات.

2. تحديد استخدم سلسلة اتصال مخصصة .

   الافتراضي القيمة Data Source = |SQL/CE|يظهر في صندوق نص.

3. لإنشاء واستخدام SQL Server Compact Edition الإصدار 3.5قاعدة البيانات، ضع الافتراضي قيمة سلسلة اتصال.Visual Studioسيقوم بإنشاء ملف قاعدة بيانات ووضعها في الدليل المشار إليهApplication.UserAppDataPathخاصية.

4. إلى إنشاء واستخدام مشفرة SQL Server Compact 3.5قاعدة بيانات، قم بإضافة passwordو encrypt databaseقيم إلى سلسلة الاتصال كما هو موضح في المثال التالي.

   ملاحظة

   تأكد من إلى تحديد كلمة مرور معقدة. لا يمكنك تغيير كلمة المرور بعد قاعدة بيانات هو التي تم إنشاؤها.

   Data Source = |SQL/CE|;password=<password>;encrypt database=true
   

5. إلى استخدام الخاصة بك SQL Serverقاعدة بيانات، حدد سلسلة الاتصال الخاصة بك. للحصول على معلومات حول التنسيقات سلسلة اتصال صالحة، انظر في SQL Serverالوثائق. لم يتم إنشاء قاعدة بيانات هذه تلقائياً. يجب أن تشير سلسلة الاتصال بقاعدة بيانات التي يمكنك إنشاؤها باستخدام عبارات SQL التالي.

   CREATE TABLE ApplicationProperties (PropertyName nvarchar(256),
       PropertyValue nvarchar(256))
   CREATE TABLE UserProperties (PropertyName nvarchar(256),
       PropertyValue nvarchar(256))
   CREATE TABLE Roles (UserName nvarchar(256), 
       RoleName nvarchar(256))
   CREATE TABLE Settings (PropertyName nvarchar(256), 
       PropertyStoredAs nvarchar(1), PropertyValue nvarchar(2048))
   

استخدام موفري مخصص

بواسطة الافتراضي، يستخدم ميزة الخدمات تطبيق العميل الموفرين في System.Web.ClientServices.Providersمساحة الاسم. عندما تقوم بتكوين تطبيق الخاص بك باستخدام من صفحة الخدمات مشروع "مصمم"، تتم تمت الإضافة مراجع إلى موفري هذه إلى ملف App.config. موفرو الافتراضية هذه الوصول إلى موفري المقابل تشغيل الملقم. غالباً ما يتم تكوين الخدمات ويب الوصول إلى بيانات مستخدم من خلال موفري مثل كـ SqlMembershipProviderو SqlRoleProvider.

إذا كنت تريد استخدم موفرو الخدمة مخصصة، فعادة ما سيتغير الموفرين تشغيل جانب الملقم حيث أنها تؤثر تشغيل الجميع تطبيقات العميل الوصول إلى الملقم. However, you do have the خيار of using non-الافتراضي providers on the client side. يمكنك تحديد مصادقة المخصصة أو موفري الأدوار في ملف مشروع الخاص بك App.config كـ هو موضح في إجراء التالي. لمعلومات حول كيفية إلى إنشاء cusإلىm موفرو مصادقة والأدوار، راجع تطبيق موفر العضويةو تطبيق موفر الدور. يمكنك أيضا استخدام موفر إعدادات مخصصة بواسطة تعديل مشروع الخاص بك Settingsclكـs (الوصول إلى كـ Properties.Settings.Defaultفي C# و My.Settingsفي Visual Basic). لمزيد من المعلومات، راجع هندسة إعدادات تطبيق.

To configure تطبيق العميل services to use non-الافتراضي providers

1. إلى استخدم مصادقة غير افتراضي أو موفر الخدمة الأدوار، أولاً باستكمال الجميع إعدادات تكوين باستخدام الصفحة الخدمات.

2. يغلق مشروع "مصمم". يعد ذلك ضروريا لأن تحديث الصفحة الالخدمات تلقائياً الخاص بك App.config ملف حتى في حالة عدم تعديل أية إعدادات. إذا قمت بتعديل App.config الخاص بك يدوياً ملف كما هو موضح في هذا إجراء وثم العودة إلى الصفحة الخدمات، سيتم يعيد تعيين المعاملة التعديلات.

3. في من مستكشف الحل، انقر نقراً مزدوجاً فوق App.config.

   فتح ملف تكوين تطبيق في محرر النصوص.

4. بحث <providers>عنصر داخل <membership>أو <roleManager>العنصر. تقوم هذه عنصر s الأطفال من <system.web>عنصر. <membership>العنصر هو يستخدم لتعيين موفري مصادقة، و <roleManager>عنصر هو المستخدمة لتعيين موفري الدور.

5. إضافة <add>عنصر كـ تابع <providers>العنصر. يجب تحديد nameو typeسمات كـ هو موضح في المثال التالي. typeسمة يجب أن تكون القيمة اسم تجميع مؤهل نوع عنصر. للمزيد من المعلومات، راجع Type.AssemblyQualifiedName وأسماء التجميع.

   <add name="MyCustomRoleProvider" type="MyNamespace.MyRoleProvider, MyAssembly" />
   

6. تعديل defaultProviderسمة <membership>أو <roleManager>عنصر إلى تعيين اسم القيمة من <add>العنصر الذي قمت بإضافته في الخطوة السابقة.

   <roleManager enabled="true" defaultProvider="MyCustomRoleProvider">
   

راجع أيضًا:

المهام

كيفية القيام بما يلي: قم بتطبيق المستخدم تسجيل الدخول إلى و تسجيل الخروج باستخدام الخدمات تطبيق العميل

كيفية القيام بما يلي: العمل بدون اتصال مع الخدمات تطبيق العميل

الإرشادات التفصيلية: استخدام الخدمات تطبيق العميل

المرجع

صفحة الخدمات، مصمم المشروع

إعدادات متقدمة لمربع حوار الخدمات

المبادئ

نظرة عامة حول الخدمات تطبيق العميل

مقدمة إلى مصمم المشروع

تطبيق موفر العضوية

تطبيق موفر الدور

هندسة إعدادات تطبيق

موارد أخرى

تطبيق العميل الخدمات

إنشاء ثم تكوين قاعدة بيانات خدمات التطبيق لـ SQL Server