ConnectionStringsSection 類別

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v9.0.0-preview.5.24306.7

來源:

ConnectionStringsSection.cs

提供連接字串組態檔區段的程式設計存取。

public ref class ConnectionStringsSection sealed : System::Configuration::ConfigurationSection

public sealed class ConnectionStringsSection : System.Configuration.ConfigurationSection

type ConnectionStringsSection = class
    inherit ConfigurationSection

Public NotInheritable Class ConnectionStringsSection
Inherits ConfigurationSection

繼承

Object

ConfigurationElement

ConfigurationSection

ConnectionStringsSection

範例

下列範例示範如何使用 ConnectionStringsSection。

       // Create a connectionn string element and add it to
       // the connection strings section.
       static ConnectionStrings()
       {
           // Get the application configuration file.
           System.Configuration.Configuration config =
                   ConfigurationManager.OpenExeConfiguration(
                   ConfigurationUserLevel.None);

           // Get the current connection strings count.
           int connStrCnt = 
               ConfigurationManager.ConnectionStrings.Count;

           // Create the connection string name. 
           string csName = 
               "ConnStr" + connStrCnt.ToString();

           // Create a connection string element and
           // save it to the configuration file.
          
           // Create a connection string element.
           ConnectionStringSettings csSettings =
                   new ConnectionStringSettings(csName,
                   "LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;" +
                   "Initial Catalog=aspnetdb", "System.Data.SqlClient");

           // Get the connection strings section.
           ConnectionStringsSection csSection =
               config.ConnectionStrings;

           // Add the new element.
           csSection.ConnectionStrings.Add(csSettings);
               
           // Save the configuration file.
           config.Save(ConfigurationSaveMode.Modified);
       }

' Create a connectionn string element and add it to
' the connection strings section.
Shared Sub New() 

    ' Get the application configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)
    
    ' Get the current connection strings count.
    Dim connStrCnt As Integer = _
    ConfigurationManager.ConnectionStrings.Count
    
    ' Create the connection string name. 
    Dim csName As String = "ConnStr" + connStrCnt.ToString()
    
    ' Create a connection string element and
    ' save it to the configuration file.
    ' Create a connection string element.
    Dim csSettings _
    As New ConnectionStringSettings( _
    csName, _
    "LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;" + _
    "Initial Catalog=aspnetdb", "System.Data.SqlClient")
    
    ' Get the connection strings section.
    Dim csSection _
    As ConnectionStringsSection = _
    config.ConnectionStrings
    
    ' Add the new element.
    csSection.ConnectionStrings.Add(csSettings)
    
    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)

End Sub

下列摘錄顯示上一個範例所使用的組態。

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

備註

ConnectionStringsSection 類別可讓您以程序設計方式修改組態檔的 connectionStrings 區段。 連接字串會以 ConnectionStringSettingsadd 組態專案的 ConnectionStringSettingsCollection 的形式提供。

建構函式

ConnectionStringsSection()

初始化 ConnectionStringsSection 類別的新實例。

屬性

ConnectionStrings	取得 ConnectionStringSettings 物件的 ConnectionStringSettingsCollection 集合。
CurrentConfiguration	取得最上層 Configuration 實例的參考，表示目前 ConfigurationElement 實例所屬的組態階層。 (繼承來源 ConfigurationElement)
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件的不可自定義資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得代表 ConfigurationElement 物件本身的 ConfigurationElementProperty 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，這個值表示 CurrentConfiguration 屬性是否 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定這個組態項目的屬性或屬性。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定這個組態專案的屬性、屬性或子專案。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出專案是否已鎖定。 (繼承來源 ConfigurationElement)
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
SectionInformation	取得 SectionInformation 物件，其中包含 ConfigurationSection 物件不可自定義的資訊和功能。 (繼承來源 ConfigurationSection)

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
DeserializeSection(XmlReader)	從組態檔讀取 XML。 (繼承來源 ConfigurationSection)
Equals(Object)	比較目前 ConfigurationElement 實例與指定的物件。 (繼承來源 ConfigurationElement)
GetHashCode()	取得代表目前 ConfigurationElement 實例的唯一值。 (繼承來源 ConfigurationElement)
GetRuntimeObject()	在衍生類別中覆寫時，傳回自定義物件。 (繼承來源 ConfigurationSection)
GetTransformedAssemblyString(String)	傳回所指定元件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為其初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	指出此組態專案自上次儲存或載入衍生類別時是否已修改。 (繼承來源 ConfigurationSection)
IsReadOnly()	取得值，指出 ConfigurationElement 物件是否為唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	將這個 ConfigurationElement 物件和所有子元素中的無效屬性錯誤新增至傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出還原串行化期間是否遇到未知的屬性。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出還原串行化期間是否遇到未知的專案。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	找不到必要屬性時擲回例外狀況。 (繼承來源 ConfigurationElement)
PostDeserialize()	在還原串行化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	在串行化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重設 ConfigurationElement 對象的內部狀態，包括鎖定和屬性集合。 (繼承來源 ConfigurationElement)
ResetModified()	在衍生類別中實作時，將 IsModified() 方法的值重設為 false。 (繼承來源 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態專案的內容寫入組態檔。 (繼承來源 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	建立 XML 字串，其中包含 ConfigurationSection 物件的未合併檢視，做為要寫入檔案的單一區段。 (繼承來源 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態專案的外部標記寫入組態檔。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 ConfigurationElement 物件和所有子元素的 IsReadOnly() 屬性。 (繼承來源 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	指出當組態物件階層針對 .NET Framework 的指定目標版本串行化時，是否應該串行化指定的專案。 (繼承來源 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	指出當組態物件階層針對 .NET Framework 的指定目標版本串行化時，是否應該串行化指定的屬性。 (繼承來源 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	指出當組態物件階層針對 .NET Framework 的指定目標版本串行化時，目前的 ConfigurationSection 實例是否應該串行化。 (繼承來源 ConfigurationSection)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，移除不應儲存的所有值。 (繼承來源 ConfigurationElement)

另請參閱

• ConnectionStringSettingsCollection
• ConnectionStringSettings