ConnectionStringSettingsCollection Класс

Определение

Содержит коллекцию объектов ConnectionStringSettings.Contains a collection of ConnectionStringSettings objects.

public ref class ConnectionStringSettingsCollection sealed : System::Configuration::ConfigurationElementCollection
[System.Configuration.ConfigurationCollection(typeof(System.Configuration.ConnectionStringSettings), CollectionType=System.Configuration.ConfigurationElementCollectionType.AddRemoveClearMap)]
[System.Configuration.ConfigurationCollection(typeof(System.Configuration.ConnectionStringSettings))]
public sealed class ConnectionStringSettingsCollection : System.Configuration.ConfigurationElementCollection
type ConnectionStringSettingsCollection = class
    inherit ConfigurationElementCollection
Public NotInheritable Class ConnectionStringSettingsCollection
Inherits ConfigurationElementCollection
Наследование
ConnectionStringSettingsCollection
Атрибуты

Примеры

В следующем примере показано, ConnectionStringSettingsCollectionкак получить доступ к.The following example shows how to access the ConnectionStringSettingsCollection.

static void ShowConnectionStrings()
{
     // Get the application configuration file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

    // Get the conectionStrings section.
    ConnectionStringsSection csSection =
        config.ConnectionStrings;
    
    for (int i = 0; i < 
        ConfigurationManager.ConnectionStrings.Count; i++)
    {
        ConnectionStringSettings cs = 
            csSection.ConnectionStrings[i];
        
        Console.WriteLine("  Connection String: \"{0}\"",
            cs.ConnectionString);

        Console.WriteLine("#{0}", i);
        Console.WriteLine("  Name: {0}", cs.Name);
     
        
        Console.WriteLine("  Provider Name: {0}", 
            cs.ProviderName);
        
    }

}
Shared Sub ShowConnectionStrings() 

    ' Get the application configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)

    ' Get the conectionStrings section.
    Dim csSection _
    As ConnectionStringsSection = _
    config.ConnectionStrings
    
    For i As Integer = 0 To ConfigurationManager.ConnectionStrings.Count - 1
        Dim cs As ConnectionStringSettings = _
        csSection.ConnectionStrings(i)
        
        Console.WriteLine( _
        "  Connection String: ""{0}""", cs.ConnectionString)
        Console.WriteLine("#{0}", i)
        Console.WriteLine("  Name: {0}", cs.Name)
        
        Console.WriteLine( _
        "  Provider Name: {0}", cs.ProviderName)

    Next i

End Sub

Следующий пример является выдержкой из файла конфигурации, используемого в предыдущем примере.The following example is an excerpt from the configuration file used by the previous example.

<?xml version="1.0" encoding="utf-8"?>  
<configuration>  
  <connectionStrings>  
    <add name="ConnStr1" connectionString="LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;Initial Catalog=aspnetdb"  
      providerName="System.Data.SqlClient" />  
  </connectionStrings>  
</configuration>  

Комментарии

ConnectionStringSettingsCollection Объект содержитConnectionStringSettings коллекцию объектов.A ConnectionStringSettingsCollection object contains a collection of ConnectionStringSettings objects. Каждый ConnectionStringSettings объект представляет одну запись <connectionStrings> в разделе файла конфигурации.Each ConnectionStringSettings object represents a single entry in the <connectionStrings> configuration-file section.

Конструкторы

ConnectionStringSettingsCollection()

Инициализирует новый экземпляр класса ConnectionStringSettingsCollection.Initializes a new instance of the ConnectionStringSettingsCollection class.

Свойства

AddElementName

Возвращает или устанавливает имя ConfigurationElement, связанное с операцией добавления в ConfigurationElementCollection после переопределения в производном классе.Gets or sets the name of the ConfigurationElement to associate with the add operation in the ConfigurationElementCollection when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
ClearElementName

Возвращает или задает имя ConfigurationElement, связанное с операцией очистки в ConfigurationElementCollection после переопределения в производном классе.Gets or sets the name for the ConfigurationElement to associate with the clear operation in the ConfigurationElementCollection when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
CollectionType

Получает тип объекта ConfigurationElementCollection.Gets the type of the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
Count

Возвращает количество элементов в коллекции.Gets the number of elements in the collection.

(Унаследовано от ConfigurationElementCollection)
CurrentConfiguration

Возвращает ссылку на экземпляр Configuration верхнего уровня, представляющий иерархию конфигурации, к которой относится текущий экземпляр ConfigurationElement.Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Унаследовано от ConfigurationElement)
ElementInformation

Возвращает объект ElementInformation, содержащий неизменяемую информацию и функциональность объекта ConfigurationElement.Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Унаследовано от ConfigurationElement)
ElementName

Получает имя, используемое для данной коллекции элементов в файле конфигурации после переопределения в производном классе.Gets the name used to identify this collection of elements in the configuration file when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
ElementProperty

Возвращает объект ConfigurationElementProperty, представляющий сам объект ConfigurationElement.Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Унаследовано от ConfigurationElement)
EmitClear

Получает или задает значение, указывающее, была ли коллекция очищена.Gets or sets a value that specifies whether the collection has been cleared.

(Унаследовано от ConfigurationElementCollection)
EvaluationContext

Возвращает объект ContextInformation для объекта ConfigurationElement.Gets the ContextInformation object for the ConfigurationElement object.

(Унаследовано от ConfigurationElement)
HasContext

Возвращает значение, указывающее, имеет ли свойство CurrentConfiguration значение null.Gets a value that indicates whether the CurrentConfiguration property is null.

(Унаследовано от ConfigurationElement)
IsSynchronized

Возвращает значение, указывающее, является ли доступ к коллекции синхронизированным.Gets a value indicating whether access to the collection is synchronized.

(Унаследовано от ConfigurationElementCollection)
Item[ConfigurationProperty]

Возвращает или задает свойство или атрибут данного элемента конфигурации.Gets or sets a property or attribute of this configuration element.

(Унаследовано от ConfigurationElement)
Item[Int32]

Возвращает или задает строку подключения в коллекции по указанному индексу.Gets or sets the connection string at the specified index in the collection.

Item[String]

Возвращает или задает объект ConnectionStringSettings с указанным именем в коллекции.Gets or sets the ConnectionStringSettings object with the specified name in the collection.

LockAllAttributesExcept

Возвращает коллекцию заблокированных атрибутов.Gets the collection of locked attributes.

(Унаследовано от ConfigurationElement)
LockAllElementsExcept

Возвращает коллекцию заблокированных элементов.Gets the collection of locked elements.

(Унаследовано от ConfigurationElement)
LockAttributes

Возвращает коллекцию заблокированных атрибутов.Gets the collection of locked attributes.

(Унаследовано от ConfigurationElement)
LockElements

Возвращает коллекцию заблокированных элементов.Gets the collection of locked elements.

(Унаследовано от ConfigurationElement)
LockItem

Возвращает или задает значение, указывающее, заблокирован ли элемент.Gets or sets a value indicating whether the element is locked.

(Унаследовано от ConfigurationElement)
Properties

Возвращает коллекцию свойств.Gets the collection of properties.

(Унаследовано от ConfigurationElement)
RemoveElementName

Получает или задает имя ConfigurationElement, связанное с операцией удаления в ConfigurationElementCollection после переопределения в производном классе.Gets or sets the name of the ConfigurationElement to associate with the remove operation in the ConfigurationElementCollection when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
SyncRoot

Получает объект, используемый для синхронизации доступа к ConfigurationElementCollection.Gets an object used to synchronize access to the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
ThrowOnDuplicate

Возвращает значение, указывающее выдаст ли исключение попытка добавить дубликат ConfigurationElement к ConfigurationElementCollection.Gets a value indicating whether an attempt to add a duplicate ConfigurationElement to the ConfigurationElementCollection will cause an exception to be thrown.

(Унаследовано от ConfigurationElementCollection)

Методы

Add(ConnectionStringSettings)

Добавляет объект ConnectionStringSettings в коллекцию.Adds a ConnectionStringSettings object to the collection.

BaseAdd(ConfigurationElement)

Добавляет новый элемент конфигурации в ConfigurationElementCollection.Adds a configuration element to the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)

Добавляет элемент конфигурации в коллекцию элементов конфигурации.Adds a configuration element to the configuration element collection.

(Унаследовано от ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)

Добавляет элемент конфигурации в коллекцию элементов конфигурации.Adds a configuration element to the configuration element collection.

(Унаследовано от ConfigurationElementCollection)
BaseClear()

Удаляет все объекты элементов конфигурации из коллекции.Removes all configuration element objects from the collection.

(Унаследовано от ConfigurationElementCollection)
BaseGet(Int32)

Возвращает элемент конфигурации с указанным расположением индекса.Gets the configuration element at the specified index location.

(Унаследовано от ConfigurationElementCollection)
BaseGet(Object)

Возвращает элемент конфигурации с указанным ключом.Returns the configuration element with the specified key.

(Унаследовано от ConfigurationElementCollection)
BaseGetAllKeys()

Возвращает массив ключей для всех элементов конфигурации, содержащихся в ConfigurationElementCollection.Returns an array of the keys for all of the configuration elements contained in the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
BaseGetKey(Int32)

Получает ключ объекта ConfigurationElement по указанному расположению индекса.Gets the key for the ConfigurationElement at the specified index location.

(Унаследовано от ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)

Указывает индекс заданного объекта ConfigurationElement.Indicates the index of the specified ConfigurationElement.

(Унаследовано от ConfigurationElementCollection)
BaseIsRemoved(Object)

Указывает, удален ли ConfigurationElement с указанным ключом из ConfigurationElementCollection.Indicates whether the ConfigurationElement with the specified key has been removed from the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
BaseRemove(Object)

Удаляет объект ConfigurationElement из коллекции.Removes a ConfigurationElement from the collection.

(Унаследовано от ConfigurationElementCollection)
BaseRemoveAt(Int32)

Удаляет объект ConfigurationElement по указанному расположению индекса.Removes the ConfigurationElement at the specified index location.

(Унаследовано от ConfigurationElementCollection)
Clear()

Удаляет все объекты ConnectionStringSettings из коллекции.Removes all the ConnectionStringSettings objects from the collection.

CopyTo(ConfigurationElement[], Int32)

Копирует содержимое объекта ConfigurationElementCollection в массив.Copies the contents of the ConfigurationElementCollection to an array.

(Унаследовано от ConfigurationElementCollection)
CreateNewElement()

При переопределении в производном классе создает новый объект ConfigurationElement.When overridden in a derived class, creates a new ConfigurationElement.

(Унаследовано от ConfigurationElementCollection)
CreateNewElement(String)

При переопределении в производном классе создает новый элемент ConfigurationElement.Creates a new ConfigurationElement when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)

Считывает XML из файла конфигурации.Reads XML from the configuration file.

(Унаследовано от ConfigurationElement)
Equals(Object)

Сравнивает ConfigurationElementCollection с указанным объектом.Compares the ConfigurationElementCollection to the specified object.

(Унаследовано от ConfigurationElementCollection)
GetElementKey(ConfigurationElement)

При переопределении в производном классе возвращает ключ указанного элемента конфигурации.Gets the element key for a specified configuration element when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
GetEnumerator()

Получает метод IEnumerator, используемый для итерации по ConfigurationElementCollection.Gets an IEnumerator which is used to iterate through the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
GetHashCode()

Получает уникальное значение, представляющее экземпляр ConfigurationElementCollection.Gets a unique value representing the ConfigurationElementCollection instance.

(Унаследовано от ConfigurationElementCollection)
GetTransformedAssemblyString(String)

Возвращает преобразованную версию указанного имени сборки.Returns the transformed version of the specified assembly name.

(Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)

Возвращает преобразованную версию указанного имени типа.Returns the transformed version of the specified type name.

(Унаследовано от ConfigurationElement)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IndexOf(ConnectionStringSettings)

Возвращает индекс коллекции передаваемого объекта ConnectionStringSettings.Returns the collection index of the passed ConnectionStringSettings object.

Init()

Задает объект ConfigurationElement в исходное состояние.Sets the ConfigurationElement object to its initial state.

(Унаследовано от ConfigurationElement)
InitializeDefault()

Используется для инициализации набора значений по умолчанию для объекта ConfigurationElement.Used to initialize a default set of values for the ConfigurationElement object.

(Унаследовано от ConfigurationElement)
IsElementName(String)

Указывает, существует ли указанный ConfigurationElement в ConfigurationElementCollection.Indicates whether the specified ConfigurationElement exists in the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)

Указывает, может ли указанный объект ConfigurationElement быть удален из ConfigurationElementCollection.Indicates whether the specified ConfigurationElement can be removed from the ConfigurationElementCollection.

(Унаследовано от ConfigurationElementCollection)
IsModified()

Указывает, был ли изменен ConfigurationElementCollection с момента последнего сохранения или загрузки после переопределения в производном классе.Indicates whether this ConfigurationElementCollection has been modified since it was last saved or loaded when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
IsReadOnly()

Указывает, доступен ли объект ConfigurationElementCollection только для чтения.Indicates whether the ConfigurationElementCollection object is read only.

(Унаследовано от ConfigurationElementCollection)
ListErrors(IList)

Добавляет ошибку "недействительное свойство" в данном объекте ConfigurationElement и всех его дочерних элементах к переданному списку.Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Унаследовано от ConfigurationElement)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)

Возвращает значение, указывающее, встретился ли неизвестный атрибут при десериализации.Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Приводит к тому, что система конфигурации выдает исключение.Causes the configuration system to throw an exception.

(Унаследовано от ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)

Выдает исключение, если требуемое свойство не найдено.Throws an exception when a required property is not found.

(Унаследовано от ConfigurationElement)
PostDeserialize()

Вызывается после десериализации.Called after deserialization.

(Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)

Вызывается до сериализации.Called before serialization.

(Унаследовано от ConfigurationElement)
Remove(ConnectionStringSettings)

Удаляет указанный объект ConnectionStringSettings из коллекции.Removes the specified ConnectionStringSettings object from the collection.

Remove(String)

Удаляет указанный объект ConnectionStringSettings из коллекции.Removes the specified ConnectionStringSettings object from the collection.

RemoveAt(Int32)

Удаляет объект ConnectionStringSettings по указанному индексу в коллекции.Removes the ConnectionStringSettings object at the specified index in the collection.

Reset(ConfigurationElement)

Сбрасывает ConfigurationElementCollection в неизмененное состояние после переопределения в производном классе.Resets the ConfigurationElementCollection to its unmodified state when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
ResetModified()

Переустанавливает значение свойства IsModified() в false при переопределении в производном классе.Resets the value of the IsModified() property to false when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)

Записывает данные конфигурации в XML-элемент в файле конфигурации после переопределения в производном классе.Writes the configuration data to an XML element in the configuration file when overridden in a derived class.

(Унаследовано от ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)

Записывает внешние теги данного элемента конфигурации в файл конфигурации при реализации в производном классе.Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Задает для свойства указанное значение.Sets a property to the specified value.

(Унаследовано от ConfigurationElement)
SetReadOnly()

Устанавливает свойство IsReadOnly() для объекта ConfigurationElementCollection и всех подчиненных элементов.Sets the IsReadOnly() property for the ConfigurationElementCollection object and for all sub-elements.

(Унаследовано от ConfigurationElementCollection)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Отменяет эффект слияния данных конфигурации на разных уровнях иерархии конфигурации.Reverses the effect of merging configuration information from different levels of the configuration hierarchy.

(Унаследовано от ConfigurationElementCollection)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)

Копирует ConfigurationElementCollection в массив.Copies the ConfigurationElementCollection to an array.

(Унаследовано от ConfigurationElementCollection)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно