ExpressionBuilderCollection Classe

Referência

Definição

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma coleção de objetos ExpressionBuilder . Essa classe não pode ser herdada.

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

Herança: Object

ConfigurationElement

ConfigurationElementCollection
ExpressionBuilderCollection

Atributos: ConfigurationCollectionAttribute

Exemplos

Esta seção fornece dois exemplos de código. O primeiro demonstra como especificar valores declarativamente para várias propriedades da ExpressionBuilderCollection classe. O segundo demonstra como usar membros da ExpressionBuilderCollection classe.

O exemplo de arquivo de configuração a seguir mostra como especificar declarativamente valores para várias propriedades da ExpressionBuilderCollection classe.

<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>

O exemplo de código a seguir demonstra como usar membros da ExpressionBuilderCollection classe.

#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

Comentários

A ExpressionBuilderCollection classe não se refere a nenhum elemento real no arquivo de configuração subjacente. É um constructo que permite acesso fácil às informações de compilação que ele contém.

Construtores

ExpressionBuilderCollection()

Inicializa uma nova instância da classe ExpressionBuilderCollection.

Propriedades

AddElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de adição no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ClearElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de limpeza no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
CollectionType	Obtém o tipo do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
Count	Obtém o número de elementos na coleção. (Herdado de ConfigurationElementCollection)
CurrentConfiguration	Obtém uma referência para a instância Configuration de nível superior que representa a hierarquia de configuração à qual a instância atual ConfigurationElement pertence. (Herdado de ConfigurationElement)
ElementInformation	Obtém um objeto ElementInformation que contém as informações não personalizáveis e a funcionalidade do objeto ConfigurationElement. (Herdado de ConfigurationElement)
ElementName	Obtém o nome usado para identificar esta coleção de elementos no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ElementProperty	Obtém o objeto ConfigurationElementProperty que representa o próprio objeto ConfigurationElement. (Herdado de ConfigurationElement)
EmitClear	Obtém ou define um valor que especifica se a coleção foi limpa. (Herdado de ConfigurationElementCollection)
EvaluationContext	Obtém o objeto ContextInformation para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
HasContext	Obtém um valor que indica se a propriedade CurrentConfiguration é `null`. (Herdado de ConfigurationElement)
IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado. (Herdado de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou um atributo desse elemento de configuração. (Herdado de ConfigurationElement)
Item[Int32]	Obtém ou define o ExpressionBuilder no índice especificado na coleção ExpressionBuilderCollection.
Item[String]	Obtém o objeto ExpressionBuilder com o nome especificado.
LockAllAttributesExcept	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockAllElementsExcept	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockAttributes	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockElements	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockItem	Obtém ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement)
Properties	Obtém a coleção de propriedades. (Herdado de ConfigurationElement)
RemoveElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de remoção no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SyncRoot	Obtém um objeto usado para sincronizar o acesso ao ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
ThrowOnDuplicate	Obtém um valor que indica se uma tentativa de adicionar uma duplicata ConfigurationElement ao ConfigurationElementCollection fará com que uma exceção seja lançada. (Herdado de ConfigurationElementCollection)

Métodos

Add(ExpressionBuilder)	Adiciona um objeto ExpressionBuilder ao ExpressionBuilderCollection.
BaseAdd(ConfigurationElement)	Adiciona um elemento de configuração ao ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseClear()	Remove todos os objetos de elemento de configuração da coleção. (Herdado de ConfigurationElementCollection)
BaseGet(Int32)	Obtém o elemento de configuração no local do índice especificado. (Herdado de ConfigurationElementCollection)
BaseGet(Object)	Retorna o elemento de configuração com a chave especificada. (Herdado de ConfigurationElementCollection)
BaseGetAllKeys()	Retorna uma matriz das chaves para todos os elementos de configuração contidos no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtém a chave para o ConfigurationElement no local do índice especificado. (Herdado de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica o índice do ConfigurationElement especificado. (Herdado de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se o ConfigurationElement com a chave especificada foi removido do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseRemove(Object)	Remove um ConfigurationElement da coleção. (Herdado de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Remove o ConfigurationElement no local de índice especificado. (Herdado de ConfigurationElementCollection)
Clear()	Limpa todos os objetos ExpressionBuilder da coleção ExpressionBuilderCollection.
CopyTo(ConfigurationElement[], Int32)	Copia o conteúdo do ConfigurationElementCollection para uma matriz. (Herdado de ConfigurationElementCollection)
CreateNewElement()	Quando substituído em uma classe derivada, cria um novo ConfigurationElement. (Herdado de ConfigurationElementCollection)
CreateNewElement(String)	Cria um novo ConfigurationElement quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lê o XML do arquivo de configuração. (Herdado de ConfigurationElement)
Equals(Object)	Compara o ConfigurationElementCollection ao objeto especificado. (Herdado de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Obtém a chave de elemento para um elemento de configuração especificado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
GetEnumerator()	Obtém um IEnumerator que é usado para iterar por meio de ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
GetHashCode()	Obtém um valor exclusivo que representa a instância ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Retorna a versão transformada do nome do assembly especificado. (Herdado de ConfigurationElement)
GetTransformedTypeString(String)	Retorna a versão transformada do nome do tipo especificado. (Herdado de ConfigurationElement)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Init()	Define o objeto ConfigurationElement para seu estado inicial. (Herdado de ConfigurationElement)
InitializeDefault()	Usado para inicializar um conjunto padrão de valores para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
IsElementName(String)	Indica se o ConfigurationElement especificado existe no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se o ConfigurationElement especificado pode ser removido de ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsModified()	Indica se este ConfigurationElementCollection foi modificado desde a última vez em que foi salvo ou carregado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
IsReadOnly()	Indica se o objeto ConfigurationElementCollection é somente leitura. (Herdado de ConfigurationElementCollection)
ListErrors(IList)	Adiciona os erros de propriedade inválida deste objeto ConfigurationElement e de todos os subelementos à lista passada. (Herdado de ConfigurationElement)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtém um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Faz com que o sistema de configuração lance uma exceção. (Herdado de ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Gera uma exceção quando uma propriedade necessária não é encontrada. (Herdado de ConfigurationElement)
PostDeserialize()	Chamado depois da desserialização. (Herdado de ConfigurationElement)
PreSerialize(XmlWriter)	Chamado antes da serialização. (Herdado de ConfigurationElement)
Remove(String)	Remove um objeto ExpressionBuilder da coleção ExpressionBuilderCollection.
RemoveAt(Int32)	Remove um objeto ExpressionBuilder da coleção ExpressionBuilderCollection.
Reset(ConfigurationElement)	Redefine o ConfigurationElementCollection para seu estado inalterado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ResetModified()	Redefine o valor da propriedade IsModified() para `false` quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Grava os dados de configuração em um elemento XML no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Grava as marcas externas desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement)
SetReadOnly()	Define a propriedade IsReadOnly() para o objeto ConfigurationElementCollection e para todos os subelementos. (Herdado de ConfigurationElementCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte o efeito da mesclagem de informações de configuração de diferentes níveis da hierarquia de configuração. (Herdado de ConfigurationElementCollection)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Copia o ConfigurationElementCollection para uma matriz.

(Herdado de ConfigurationElementCollection)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Partilhar via