ConfigurationLockCollection Osztály

Definíció

Névtér:

System.Configuration

Szerelvény:

System.Configuration.ConfigurationManager.dll

Csomag:

System.Configuration.ConfigurationManager v11.0.0-preview.5.26302.115

Forrás:

ConfigurationLockCollection.cs

Zárolt konfigurációs objektumok gyűjteményét tartalmazza. Ez az osztály nem örökölhető.

public ref class ConfigurationLockCollection sealed : System::Collections::ICollection

public sealed class ConfigurationLockCollection : System.Collections.ICollection

type ConfigurationLockCollection = class
    interface ICollection
    interface IEnumerable

Public NotInheritable Class ConfigurationLockCollection
Implements ICollection

Öröklődés

Object

ConfigurationLockCollection

Megvalósítás

ICollection IEnumerable

Példák

Az alábbi példakód bemutatja a ConfigurationLockCollection típus használatát.

#region Using directives

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

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingConfigurationLockCollection
  {
    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.
        AnonymousIdentificationSection configSection =
          (AnonymousIdentificationSection)config.GetSection
          ("system.web/anonymousIdentification");

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

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

        // Create a ConfigurationLockCollection object.
        ConfigurationLockCollection lockedAttribList;
        lockedAttribList = configSection.LockAttributes;

        // Add an attribute to the lock collection.
        if (!lockedAttribList.Contains("enabled"))
        {
          lockedAttribList.Add("enabled");
        }
        if (!lockedAttribList.Contains("cookieless"))
        {
          lockedAttribList.Add("cookieless");
        }

        // Count property.
        Console.WriteLine("Collection Count: {0}",
         lockedAttribList.Count);

        // AttributeList method.
        Console.WriteLine("AttributeList: {0}",
         lockedAttribList.AttributeList);

        // Contains method.
        Console.WriteLine("Contains 'enabled': {0}",
         lockedAttribList.Contains("enabled"));

        // HasParentElements property.
        Console.WriteLine("HasParentElements: {0}",
         lockedAttribList.HasParentElements);

        // IsModified property.
        Console.WriteLine("IsModified: {0}",
         lockedAttribList.IsModified);

        // IsReadOnly method. 
        Console.WriteLine("IsReadOnly: {0}",
         lockedAttribList.IsReadOnly("enabled"));

        // Remove a configuration object 
        // from the collection.
        lockedAttribList.Remove("cookieless");

        // Clear the collection.
        lockedAttribList.Clear();

        // Create an ArrayList to contain
        // the property items of the configuration
        // section.
        ArrayList configPropertyAL = new ArrayList(lockedAttribList.Count);
        foreach (PropertyInformation propertyItem in
          configSection.ElementInformation.Properties)
        {
          configPropertyAL.Add(propertyItem.Name.ToString());
        }
        // Copy the elements of the ArrayList to a string array.
        String[] myArr = (String[])configPropertyAL.ToArray(typeof(string));
        // Create as a comma delimited list.
        string propList = string.Join(",", myArr);
        // Lock the items in the list.
        lockedAttribList.SetFromList(propList);
      }

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

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

Imports System.Configuration
Imports System.Web.Configuration
Imports System.Collections
Imports System.Text

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingConfigurationLockCollection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As _
        AnonymousIdentificationSection = _
         CType(config.GetSection("system.web/anonymousIdentification"), _
         AnonymousIdentificationSection)

        ' Display title and info.
        Console.WriteLine("Configuration Info")
        Console.WriteLine()

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

        ' Create a ConfigurationLockCollection object.
        Dim lockedAttribList As ConfigurationLockCollection
        lockedAttribList = configSection.LockAttributes

        ' Add an attribute to the lock collection.
        If Not (lockedAttribList.Contains("enabled")) Then
          lockedAttribList.Add("enabled")
        End If
        If Not (lockedAttribList.Contains("cookieless")) Then
          lockedAttribList.Add("cookieless")
        End If

        ' Count property.
        Console.WriteLine("Collection Count: {0}", _
         lockedAttribList.Count)

        ' AttributeList method.
        Console.WriteLine("AttributeList: {0}", _
         lockedAttribList.AttributeList)

        ' Contains method.
        Console.WriteLine("Contains 'enabled': {0}", _
         lockedAttribList.Contains("enabled"))

        ' HasParentElements property.
        Console.WriteLine("HasParentElements: {0}", _
         lockedAttribList.HasParentElements)

        ' IsModified property.
        Console.WriteLine("IsModified: {0}", _
         lockedAttribList.IsModified)

        ' IsReadOnly method. 
        Console.WriteLine("IsReadOnly: {0}", _
         lockedAttribList.IsReadOnly("enabled"))

        ' Remove a configuration object 
        ' from the collection.
        lockedAttribList.Remove("cookieless")

        ' Clear the collection.
        lockedAttribList.Clear()

        ' Create an ArrayList to contain
        ' the property items of the configuration
        ' section.
        Dim configPropertyAL As ArrayList = _
         New ArrayList(lockedAttribList.Count)
        For Each propertyItem As _
         PropertyInformation In _
         configSection.ElementInformation.Properties
          configPropertyAL.Add(propertyItem.Name.ToString())
        Next
        ' Copy the elements of the ArrayList to a string array.
        Dim myArr As [String]() = _
        CType(configPropertyAL.ToArray(GetType(String)), [String]())
        ' Create as a comma delimited list.
        Dim propList As String = String.Join(",", myArr)
        ' Lock the items in the list.
        lockedAttribList.SetFromList(propList)

      Catch e As Exception
        ' Validation failed.
        Console.WriteLine("Error: {0}", _
          e.Message.ToString())
      End Try

      ' Display and wait.
      Console.ReadLine()
    End Sub
  End Class
End Namespace

Megjegyzések

Egy konfigurációs fájlban a konfigurációs szakasz attribútumokat és elemeket is tartalmaz. Egy ConfigurationLockCollection gyűjtemény létezik egy konfigurációs szakasz zárolt attribútumaihoz, és az LockAttributes osztály tulajdonságán ConfigurationElement keresztül érhető el. Egy másik ConfigurationLockCollection gyűjtemény létezik egy konfigurációs szakasz zárolt elemeihez, és az LockElements osztály tulajdonságán ConfigurationElement keresztül érhető el.

Tulajdonságok

Name	Description
AttributeList	Lekéri a gyűjteményben található konfigurációs objektumok listáját.
Count	Lekéri a gyűjteményben található zárolt konfigurációs objektumok számát.
HasParentElements	Beolvas egy értéket, amely meghatározza, hogy a zárolt objektumok gyűjteménye rendelkezik-e szülőelemekkel.
IsModified	Beolvas egy értéket, amely megadja, hogy a gyűjtemény módosult-e.
IsSynchronized	Beolvas egy értéket, amely megadja, hogy a gyűjtemény szinkronizálva van-e.
SyncRoot	Lekéri a gyűjteményhez való hozzáférés szinkronizálásához ConfigurationLockCollection használt objektumot.

Metódusok

Name	Description
Add(String)	Zárol egy konfigurációs objektumot, ha hozzáadja azt a gyűjteményhez.
Clear()	Törli az összes konfigurációs objektumot a gyűjteményből.
Contains(String)	Ellenőrzi, hogy egy adott konfigurációs objektum zárolva van-e.
CopyTo(String[], Int32)	A teljes ConfigurationLockCollection gyűjteményt egy kompatibilis egydimenziósra Arraymásolja a céltömb megadott indexétől kezdve.
GetEnumerator()	Lekéri a IEnumerator gyűjteményen keresztüli ConfigurationLockCollection iteráláshoz használt objektumot.
IsReadOnly(String)	Ellenőrzi, hogy egy adott konfigurációs objektum írásvédett-e.
Remove(String)	Eltávolít egy konfigurációs objektumot a gyűjteményből.
SetFromList(String)	A megadott lista alapján zárolja a konfigurációs objektumok egy készletét.

Explicit interfész-implementációk

Name	Description
ICollection.CopyTo(Array, Int32)	A teljes ConfigurationLockCollection gyűjteményt egy kompatibilis egydimenziósra Arraymásolja a céltömb megadott indexétől kezdve.

Lásd még

• LockAllAttributesExcept
• LockAllElementsExcept
• ConfigurationElement