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.

MachineKeySection الفئة

Visual Studio 2010

قم بتعريف إعدادات تكوين التي تتحكم في إنشاء المفتاح الخورزميات التي تستخدم في العمليات التحكم (MAC) الوصول الخاص تشفير وفك تشفير وسائط في مصادقة النماذج Windows والتحقق من صحة الولاية العرض وتطبيق الولاية جلسة عمل عزل. و هذه الفئة لا يمكن أن تكون موروثة.

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

public sealed class MachineKeySection : ConfigurationSection

MachineKeySection فئة يوفر طريقة للوصول برمجياً إلى و تعديل المحتوى <MachineKey>مقطع في ملف تكوين. <MachineKey> مقطع يمكن أن يتم تكوين آلة (آلة.config) أو المستوى تطبيق (ويب.config) ويتحكم بمفاتيح الخورزميات التي تستخدم لمصادقة Windows Forms، عرض-التحقق من صحة الولاية، وعزل تطبيق الولاية جلسة عمل. لأي من هذه الميزات إلى العمل عبر شبكة الخوادم ويب (مزرعة ويب), <MachineKey>السمات يجب تكوين بوضوح والمثل صحيح قيم المفتاح. "AutoGenerate" لا يعمل القيمة لمزارع ويب، لأن ذلك يعتمد تشغيل كلمة سر عشوائية الأقوى التي هو persهوted استخدام حماية آلة المحلي ولن مترابط عبر المزيد جهاز الكمبيوتر.

ملاحظات للقائمين بالتنفيذ

إذا هو المطلوبة لتعيين مفاتيح في ترتيب هو مقطع تكوين، ك هو مطلوبة غالباً في وحدات السيناريو مزرعة ويب، فإنه هو من المستحسن أن تشفر th هو حماية المقطع باستخدام تكوين.

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

المثال التالي من تكوين ملف يوضح كيفية إلى تحديد قيم للمقطع machineKey بشكل إلزامي.

<system.web>
  <machineKey validationKey="AutoGenerate,IsolateApps" 
    decryptionKey="AutoGenerate,IsolateApps" 
    validation="SHA1"/>
</system.web>

يوضح المثال التالي كيفية إلى استخدام MachineKeySectionفئة.


#region Using directives

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingMachineKeySection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config = WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        MachineKeySection configSection = 
          (MachineKeySection)config.GetSection("system.web/machineKey");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Display ValidationKey property.
        Console.WriteLine("ValidationKey: {0}",
          configSection.ValidationKey);

        // Set ValidationKey property.
        configSection.ValidationKey = "AutoGenerate,IsolateApps";

        // Display DecryptionKey property.
        Console.WriteLine("DecryptionKey: {0}",
          configSection.DecryptionKey);

        // Set DecryptionKey property.
        configSection.DecryptionKey = "AutoGenerate,IsolateApps";

        // Display Validation property.
        Console.WriteLine("Validation: {0}",
          configSection.Validation);

        // Set Validation property.
        configSection.Validation = MachineKeyValidation.SHA1;

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait
      Console.ReadLine();
    }
  }
}


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

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