ExpressionBuilderCollection Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa una colección de ExpressionBuilder objetos. Esta clase no puede heredarse.
public ref class ExpressionBuilderCollection sealed : System::Configuration::ConfigurationElementCollection
[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ExpressionBuilder))]
public sealed class ExpressionBuilderCollection : System.Configuration.ConfigurationElementCollection
[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ExpressionBuilder))>]
type ExpressionBuilderCollection = class
inherit ConfigurationElementCollection
Public NotInheritable Class ExpressionBuilderCollection
Inherits ConfigurationElementCollection
- Herencia
- Atributos
Ejemplos
En esta sección se proporcionan dos ejemplos de código. En la primera se muestra cómo especificar de forma declarativa valores para varias propiedades de la ExpressionBuilderCollection clase . En el segundo se muestra cómo usar miembros de la ExpressionBuilderCollection clase .
En el siguiente ejemplo de archivo de configuración se muestra cómo especificar de forma declarativa valores para varias propiedades de la ExpressionBuilderCollection clase .
<system.web>
<compilation>
<expressionBuilders>
<add
expressionPrefix="Resources"
type="System.Web.Compilation.ResourceExpressionBuilder"/>
<add
expressionPrefix="ConnectionStrings"
type="System.Web.Compilation.
ConnectionStringsExpressionBuilder"/>
<add expressionPrefix="AppSettings"
type="System.Web.Compilation.AppSettingsExpressionBuilder" />
</expressionBuilders>
</compilation>
</system.web>
En el ejemplo de código siguiente se muestra cómo usar miembros de la ExpressionBuilderCollection clase .
#region Using directives
using System;
using System.Configuration;
using System.Web.Configuration;
#endregion
namespace Samples.Aspnet.SystemWebConfiguration
{
class UsingExpressionBuildCollection
{
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.
CompilationSection configSection =
(CompilationSection)config.GetSection("system.web/compilation");
// 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);
// Create a new ExpressionBuilder reference.
ExpressionBuilder myExpressionBuilder =
new ExpressionBuilder("myCustomExpression", "MyCustomExpressionBuilder");
// Add an ExpressionBuilder to the configuration.
configSection.ExpressionBuilders.Add(myExpressionBuilder);
// Add an ExpressionBuilder to the configuration.
ExpressionBuilder myExpressionBuilder2 =
new ExpressionBuilder("myCustomExpression2", "MyCustomExpressionBuilder2");
configSection.ExpressionBuilders.Add(myExpressionBuilder2);
// Display the ExpressionBuilder count.
Console.WriteLine("ExpressionBuilder Count: {0}",
configSection.ExpressionBuilders.Count);
// Display the ExpressionBuildersCollection details.
int i = 1;
int j = 1;
foreach (ExpressionBuilder expressionBuilder in configSection.ExpressionBuilders)
{
Console.WriteLine();
Console.WriteLine("ExpressionBuilder {0} Details:", i);
Console.WriteLine("Type: {0}", expressionBuilder.ElementInformation.Type);
Console.WriteLine("Source: {0}", expressionBuilder.ElementInformation.Source);
Console.WriteLine("LineNumber: {0}", expressionBuilder.ElementInformation.LineNumber);
Console.WriteLine("Properties Count: {0}", expressionBuilder.ElementInformation.Properties.Count);
j = 1;
foreach (PropertyInformation propertyItem in expressionBuilder.ElementInformation.Properties)
{
Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name);
Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value);
++j;
}
++i;
}
// Remove an ExpressionBuilder.
configSection.ExpressionBuilders.RemoveAt
(configSection.ExpressionBuilders.Count-1);
// Remove an ExpressionBuilder.
configSection.ExpressionBuilders.Remove("myCustomExpression");
// 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();
}
}
}
Imports System.Configuration
Imports System.Web.Configuration
Namespace Samples.Aspnet.SystemWebConfiguration
Class UsingExpressionBuildCollection
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 System.Web.Configuration.CompilationSection = _
CType(config.GetSection("system.web/compilation"), _
System.Web.Configuration.CompilationSection)
' 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)
' Create a new ExpressionBuilder reference.
Dim myExpressionBuilder As ExpressionBuilder = _
New ExpressionBuilder("myCustomExpression", "MyCustomExpressionBuilder")
' Add an ExpressionBuilder to the configuration.
configSection.ExpressionBuilders.Add(myExpressionBuilder)
' Add an ExpressionBuilder to the configuration.
Dim myExpressionBuilder2 As ExpressionBuilder = _
New ExpressionBuilder("myCustomExpression2", "MyCustomExpressionBuilder2")
configSection.ExpressionBuilders.Add(myExpressionBuilder2)
' Display the ExpressionBuilder count.
Console.WriteLine("ExpressionBuilder Count: {0}", _
configSection.ExpressionBuilders.Count)
' Display the ExpressionBuildersCollection details.
Dim i = 1
Dim j = 1
For Each expressionBuilder As ExpressionBuilder In configSection.ExpressionBuilders()
Console.WriteLine()
Console.WriteLine("ExpressionBuilder {0} Details:", i)
Console.WriteLine("Type: {0}", expressionBuilder.ElementInformation.Type)
Console.WriteLine("Source: {0}", expressionBuilder.ElementInformation.Source)
Console.WriteLine("LineNumber: {0}", expressionBuilder.ElementInformation.LineNumber)
Console.WriteLine("Properties Count: {0}", expressionBuilder.ElementInformation.Properties.Count)
j = 1
For Each propertyItem As PropertyInformation In expressionBuilder.ElementInformation.Properties
Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name)
Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value)
j = j + 1
Next
i = i + 1
Next
' Remove an ExpressionBuilder.
configSection.ExpressionBuilders.RemoveAt _
(configSection.ExpressionBuilders.Count - 1)
' Remove an ExpressionBuilder.
configSection.ExpressionBuilders.Remove("myCustomExpression")
' Update if not locked.
If Not configSection.SectionInformation.IsLocked Then
config.Save()
Console.WriteLine("** Configuration updated.")
Else
Console.WriteLine("** Could not update, section is locked.")
End If
Catch e As Exception
' Unknown error.
Console.WriteLine(e.ToString())
End Try
' Display and wait
Console.ReadLine()
End Sub
End Class
End Namespace
Comentarios
La ExpressionBuilderCollection clase no hace referencia a ningún elemento real en el archivo de configuración subyacente. Es una construcción que permite un acceso sencillo a la información de compilación que contiene.
Constructores
| Nombre | Description |
|---|---|
| ExpressionBuilderCollection() |
Inicializa una nueva instancia de la clase ExpressionBuilderCollection. |
Propiedades
| Nombre | Description |
|---|---|
| AddElementName |
Obtiene o establece el nombre del ConfigurationElement objeto que se va a asociar a la operación de adición en cuando ConfigurationElementCollection se invalida en una clase derivada. (Heredado de ConfigurationElementCollection) |
| ClearElementName |
Obtiene o establece el nombre del objeto que ConfigurationElement se va a asociar a la operación clear en cuando ConfigurationElementCollection se invalida en una clase derivada. (Heredado de ConfigurationElementCollection) |
| CollectionType |
Obtiene el tipo de ConfigurationElementCollection. (Heredado de ConfigurationElementCollection) |
| Count |
Obtiene el número de elementos de la colección. (Heredado de ConfigurationElementCollection) |
| CurrentConfiguration |
Obtiene una referencia a la instancia de nivel Configuration superior que representa la jerarquía de configuración a la que pertenece la instancia actual ConfigurationElement . (Heredado de ConfigurationElement) |
| ElementInformation |
Obtiene un ElementInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationElement objeto . (Heredado de ConfigurationElement) |
| ElementName |
Obtiene el nombre usado para identificar esta colección de elementos en el archivo de configuración cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection) |
| ElementProperty |
Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto. (Heredado de ConfigurationElement) |
| EmitClear |
Obtiene o establece un valor que especifica si se ha borrado la colección. (Heredado de ConfigurationElementCollection) |
| EvaluationContext |
Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| HasContext |
Obtiene un valor que indica si la CurrentConfiguration propiedad es |
| IsSynchronized |
Obtiene un valor que indica si se sincroniza el acceso a la colección. (Heredado de ConfigurationElementCollection) |
| Item[ConfigurationProperty] |
Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement) |
| Item[Int32] |
Obtiene o establece el objeto ExpressionBuilder en el índice especificado de la ExpressionBuilderCollection colección. |
| Item[String] |
Obtiene el ExpressionBuilder objeto con el nombre especificado. |
| LockAllAttributesExcept |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockAllElementsExcept |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockAttributes |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockElements |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockItem |
Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement) |
| Properties |
Obtiene la colección de propiedades. (Heredado de ConfigurationElement) |
| RemoveElementName |
Obtiene o establece el nombre del ConfigurationElement objeto que se va a asociar a la operación remove en cuando ConfigurationElementCollection se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection) |
| SyncRoot |
Obtiene un objeto utilizado para sincronizar el acceso a .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| ThrowOnDuplicate |
Obtiene un valor que indica si un intento de agregar un duplicado ConfigurationElement a ConfigurationElementCollection hará que se produzca una excepción. (Heredado de ConfigurationElementCollection) |
Métodos
| Nombre | Description |
|---|---|
| Add(ExpressionBuilder) |
Agrega un ExpressionBuilder objeto a .ExpressionBuilderCollection |
| BaseAdd(ConfigurationElement, Boolean) |
Agrega un elemento de configuración a la colección de elementos de configuración. (Heredado de ConfigurationElementCollection) |
| BaseAdd(ConfigurationElement) |
Agrega un elemento de configuración a .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| BaseAdd(Int32, ConfigurationElement) |
Agrega un elemento de configuración a la colección de elementos de configuración. (Heredado de ConfigurationElementCollection) |
| BaseClear() |
Quita todos los objetos de elemento de configuración de la colección. (Heredado de ConfigurationElementCollection) |
| BaseGet(Int32) |
Obtiene el elemento de configuración en la ubicación de índice especificada. (Heredado de ConfigurationElementCollection) |
| BaseGet(Object) |
Devuelve el elemento de configuración con la clave especificada. (Heredado de ConfigurationElementCollection) |
| BaseGetAllKeys() |
Devuelve una matriz de las claves para todos los elementos de configuración contenidos en .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| BaseGetKey(Int32) |
Obtiene la clave de en ConfigurationElement la ubicación de índice especificada. (Heredado de ConfigurationElementCollection) |
| BaseIndexOf(ConfigurationElement) |
Indica el índice del especificado ConfigurationElement. (Heredado de ConfigurationElementCollection) |
| BaseIsRemoved(Object) |
Indica si el ConfigurationElement objeto con la clave especificada se ha quitado de .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| BaseRemove(Object) |
Quita un ConfigurationElement elemento de la colección. (Heredado de ConfigurationElementCollection) |
| BaseRemoveAt(Int32) |
Quita en ConfigurationElement la ubicación de índice especificada. (Heredado de ConfigurationElementCollection) |
| Clear() |
Borra todos los ExpressionBuilder objetos de la ExpressionBuilderCollection colección. |
| CopyTo(ConfigurationElement[], Int32) |
Copia el contenido de en ConfigurationElementCollection una matriz. (Heredado de ConfigurationElementCollection) |
| CreateNewElement() |
Cuando se reemplaza en una clase derivada, crea un nuevo ConfigurationElement. (Heredado de ConfigurationElementCollection) |
| CreateNewElement(String) |
Crea un nuevo ConfigurationElement cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection) |
| DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
| Equals(Object) |
Compara con ConfigurationElementCollection el objeto especificado. (Heredado de ConfigurationElementCollection) |
| GetElementKey(ConfigurationElement) |
Obtiene la clave de elemento de un elemento de configuración especificado cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection) |
| GetEnumerator() |
Obtiene un IEnumerator objeto que se usa para recorrer en iteración .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| GetHashCode() |
Obtiene un valor único que representa la ConfigurationElementCollection instancia. (Heredado de ConfigurationElementCollection) |
| GetTransformedAssemblyString(String) |
Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Init() |
Establece el ConfigurationElement objeto en su estado inicial. (Heredado de ConfigurationElement) |
| InitializeDefault() |
Se usa para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto . (Heredado de ConfigurationElement) |
| IsElementName(String) |
Indica si el especificado ConfigurationElement existe en .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| IsElementRemovable(ConfigurationElement) |
Indica si el objeto especificado ConfigurationElement se puede quitar de .ConfigurationElementCollection (Heredado de ConfigurationElementCollection) |
| IsModified() |
Indica si ConfigurationElementCollection se ha modificado desde que se guardó o cargó por última vez cuando se invalidó en una clase derivada. (Heredado de ConfigurationElementCollection) |
| IsReadOnly() |
Indica si el ConfigurationElementCollection objeto es de solo lectura. (Heredado de ConfigurationElementCollection) |
| ListErrors(IList) |
Agrega los errores de propiedad no válida en este ConfigurationElement objeto y, en todos los subelementos, a la lista pasada. (Heredado de ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se encuentra un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Hace que el sistema de configuración produzca una excepción. (Heredado de ConfigurationElementCollection) |
| OnRequiredPropertyNotFound(String) |
Produce una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
| PostDeserialize() |
Se llama después de la deserialización. (Heredado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Se llama antes de la serialización. (Heredado de ConfigurationElement) |
| Remove(String) |
Quita un ExpressionBuilder objeto de la ExpressionBuilderCollection colección. |
| RemoveAt(Int32) |
Quita un ExpressionBuilder objeto de la ExpressionBuilderCollection colección. |
| Reset(ConfigurationElement) |
Restablece a ConfigurationElementCollection su estado sin modificar cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection) |
| ResetModified() |
Restablece el valor de la IsModified() propiedad a |
| SerializeElement(XmlWriter, Boolean) |
Escribe los datos de configuración en un elemento XML del archivo de configuración cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection) |
| SerializeToXmlElement(XmlWriter, String) |
Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement) |
| SetReadOnly() |
Establece la IsReadOnly() propiedad para el ConfigurationElementCollection objeto y para todos los subelementos. (Heredado de ConfigurationElementCollection) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Invierte el efecto de combinar información de configuración de diferentes niveles de la jerarquía de configuración. (Heredado de ConfigurationElementCollection) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia en ConfigurationElementCollection una matriz. (Heredado de ConfigurationElementCollection) |
Métodos de extensión
| Nombre | Description |
|---|---|
| AsParallel(IEnumerable) |
Habilita la paralelización de una consulta. |
| AsQueryable(IEnumerable) |
Convierte un IEnumerable en un IQueryable. |
| Cast<TResult>(IEnumerable) |
Convierte los elementos de un IEnumerable al tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra los elementos de un IEnumerable en función de un tipo especificado. |