ConnectionStringsSection クラス

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v9.0.0-rc.1.24431.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	現在の ConfigurationElement インスタンスが属している構成階層を表す最上位 Configuration インスタンスへの参照を取得します。 (継承元 ConfigurationElement)
ElementInformation	ConfigurationElement オブジェクトのカスタマイズ不可能な情報と機能を含む ElementInformation オブジェクトを取得します。 (継承元 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	ConfigurationSection オブジェクトのカスタマイズ不可能な情報と機能を含む SectionInformation オブジェクトを取得します。 (継承元 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)	ファイルに書き込む単一のセクションとして、ConfigurationSection オブジェクトの結合されていないビューを含む XML 文字列を作成します。 (継承元 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