Compartir a través de

ConfigurationElement Clase

  • Referencia

Definición

Espacio de nombres:
Microsoft.Web.Administration
Ensamblado:
Microsoft.Web.Administration.dll

Representa un elemento de un archivo de configuración.

public ref class ConfigurationElement
public class ConfigurationElement
type ConfigurationElement = class
Public Class ConfigurationElement
Herencia
Object
ConfigurationElement
Derivado

Ejemplos

En el ejemplo siguiente se implementan varios de los métodos y propiedades de la ConfigurationElement clase . En este ejemplo se obtiene un ConfigurationSection objeto para la moduleProvider sección y se obtiene de ConfigurationElementCollection esa sección. En este ejemplo se recorre en iteración cada ConfigurationElement una de las colecciones recuperadas.

[ModuleServiceMethod(PassThrough = true)]
public ArrayList GetElementCollection()
{
    // Use an ArrayList to transfer objects to the client.
    ArrayList arrayOfConfigPropertyBags = new ArrayList();

    ServerManager serverManager = new ServerManager();
    Configuration administrationConfig = serverManager.GetAdministrationConfiguration();
    ConfigurationSection moduleProvidersSection = 
        administrationConfig.GetSection("moduleProviders");
    ConfigurationElementCollection elementCollection = 
        moduleProvidersSection.GetCollection();
    // If there is a configuration element with the name of TestDemo(Modified), delete it.
    ConfigurationElement elementtoremove = null;
    foreach (ConfigurationElement moduleproviderelement in elementCollection)
    {
        if(moduleproviderelement.Attributes["name"].Value.ToString() == "TestDemo(Modified)")
        {
            elementtoremove = moduleproviderelement;
        }
    }
    if (elementtoremove != null)
    {
        elementCollection.Remove(elementtoremove);
    }
    foreach (ConfigurationElement moduleproviderelement in elementCollection)
    {
        PropertyBag elementBag = new PropertyBag();
        elementBag[ConfigurationDemoGlobals.SchemaName] = 
            moduleproviderelement.Schema.Name;
        elementBag[ConfigurationDemoGlobals.ElementTagName] = 
            moduleproviderelement.ElementTagName;
        ArrayList attributeArrayList = new ArrayList();
        // Loop through all attributes in the element attribute list.
        // Get the attribute name and value.
        foreach (ConfigurationAttribute attribute in moduleproviderelement.Attributes)
        {
            PropertyBag attributeBag = new PropertyBag();
            attributeBag[ConfigurationDemoGlobals.AttributeName] = attribute.Name;
            attributeBag[ConfigurationDemoGlobals.AttributeValue] = attribute.Value;
            // Change the value of the provider name "TestDemo" to "TestDemo(Modified)".
            if (attribute.Value.ToString() == "TestDemo")
            {
                // Use any of the following lines to set the attribute value.
                // attribute.Value = "TestDemo(Modified)";
                moduleproviderelement.SetAttributeValue(
                    "name", "TestDemo(Modified)");
                // moduleproviderelement["name"] = "TestDemo(Modified)";
                // Use any of the following lines to retrieve the attribute value.
                // attributeBag[ConfigurationDemoGlobals.AttributeName] = "name";
                attributeBag[ConfigurationDemoGlobals.AttributeName] =
                    moduleproviderelement.GetAttributeValue("name");
                // attributeBag[ConfigurationDemoGlobals.AttributeName] =
                //    moduleproviderelement["name"];
                // Set the element's lockItem attribute.
                moduleproviderelement.SetMetadata("lockItem", true); // persisted in Administration.config          

            }
            attributeArrayList.Add(attributeBag);
        }
        elementBag[ConfigurationDemoGlobals.AttributeArrayList] = attributeArrayList;
        arrayOfConfigPropertyBags.Add(elementBag);
    }
    // Create a new element. It must have a unique name.
    ConfigurationElement newelement;
    bool newelementexists = false;
    foreach (ConfigurationElement element in elementCollection)
    {
        if (element.Attributes["name"].Value.ToString() == "TestDemo")
        {
            newelementexists = true;
        }
    }
    if (!newelementexists)
    {
        newelement = elementCollection.CreateElement("add");
        newelement.Attributes["name"].Value = "TestDemo";
        newelement.Attributes["Type"].Value = "TestDemo.TestDemoModuleProvider, TestDemo, Version=1.0.0.0, Culture=neutral, PublicKeyToken=104f78e73dc54601";
        elementCollection.Add(newelement);
    }
    // CommitChanges to persist the changes to Administration.config.
    serverManager.CommitChanges();
    return arrayOfConfigPropertyBags;
}

Comentarios

Esta es la clase base para muchas entidades de configuración, incluidas secciones de configuración, entradas de colección y elementos anidados en una sección.

Constructores

ConfigurationElement()

Inicializa una nueva instancia de la clase ConfigurationElement.

Propiedades

Attributes

Obtiene una colección de atributos de configuración que contiene la lista de atributos de este elemento.
ChildElements

Obtiene todos los elementos secundarios del elemento actual.
ElementTagName

Representa un elemento de un archivo de configuración.
IsLocallyStored

Obtiene un valor que indica si el elemento de configuración se almacena en un archivo de configuración determinado.
Item[String]

Obtiene o establece un atributo con el nombre especificado.
Methods

Obtiene una colección de métodos para el elemento de configuración.
RawAttributes

Representa un elemento de un archivo de configuración.
Schema

Obtiene el esquema del elemento actual.

Métodos

Delete()

Representa un elemento de un archivo de configuración.
GetAttribute(String)

Devuelve un ConfigurationAttribute objeto que representa el atributo solicitado.
GetAttributeValue(String)

Devuelve el valor del atributo especificado.
GetChildElement(String)

Devuelve un elemento secundario que está bajo el elemento de configuración actual y tiene el nombre especificado.
GetChildElement(String, Type)

Devuelve un elemento secundario que está bajo el elemento de configuración actual y tiene el nombre y el tipo especificados.
GetCollection()

Devuelve la colección predeterminada para el elemento de configuración actual.
GetCollection(String)

Devuelve todos los elementos de configuración que pertenecen al elemento de configuración actual.
GetCollection(String, Type)

Devuelve el elemento de configuración que tiene el nombre y el tipo especificados y está bajo el elemento de configuración actual.
GetCollection(Type)

Devuelve el elemento de configuración que tiene el tipo especificado y está bajo el elemento de configuración actual.
GetMetadata(String)

Devuelve valores de metadatos del esquema de elementos.
SetAttributeValue(String, Object)

Establece el valor del atributo especificado.
SetMetadata(String, Object)

Establece los valores de metadatos del esquema de elementos.

Se aplica a