System.Configuration.ConnectionStringSettings 类

方法描述

表示连接字符串配置文件节中的单个命名连接字符串。

语法定义(C# System.Configuration.ConnectionStringSettings 类 的用法)

public sealed class ConnectionStringSettings : ConfigurationElement

构造函数

构造函数名称 构造函数描述
ConnectionStringSettings() 初始化 ConnectionStringSettings 类的新实例。
ConnectionStringSettings(String, String) 初始化 ConnectionStringSettings 类的新实例。
ConnectionStringSettings(String, String, String) 初始化 ConnectionStringSettings 对象的新实例。

成员/方法

方法名称 方法描述
DeserializeElement 读取配置文件中的 XML。 (继承自 ConfigurationElement。)
Equals 将当前的 ConfigurationElement 实例与指定的对象进行比较。 (继承自 ConfigurationElement。)
Finalize 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
GetHashCode 获取一个唯一值,表示当前 ConfigurationElement 实例。 (继承自 ConfigurationElement。)
GetTransformedAssemblyString 返回指定程序集名称的转换版本。 (继承自 ConfigurationElement。)
GetTransformedTypeString 返回指定类型名称的转换版本。 (继承自 ConfigurationElement。)
GetType 获取当前实例的 Type。 (继承自 Object。)
Init 将 ConfigurationElement 对象设置为其初始状态。 (继承自 ConfigurationElement。)
InitializeDefault 用于初始化 ConfigurationElement 对象的默认值集。 (继承自 ConfigurationElement。)
IsModified 指示此配置元素自上次被保存或加载后,直到在派生类中被实现时,是否已经更改。 (继承自 ConfigurationElement。)
IsReadOnly 获取一个值,该值指示 ConfigurationElement 对象是否为只读。 (继承自 ConfigurationElement。)
ListErrors 将此 ConfigurationElement 对象以及所有子元素中无效属性的错误添加到传递的列表中。 (继承自 ConfigurationElement。)
MemberwiseClone 创建当前 Object 的浅表副本。 (继承自 Object。)
OnDeserializeUnrecognizedAttribute 获取一个值,该值指示反序列化过程中是否遇到未知特性。 (继承自 ConfigurationElement。)
OnDeserializeUnrecognizedElement 获取一个值,该值指示反序列化过程中是否遇到未知元素。 (继承自 ConfigurationElement。)
OnRequiredPropertyNotFound 未找到所需属性时引发异常。 (继承自 ConfigurationElement。)
PostDeserialize 反序列化后调用。 (继承自 ConfigurationElement。)
PreSerialize 序列化前调用。 (继承自 ConfigurationElement。)
Reset 重置 ConfigurationElement 对象的内部状态,包括锁和属性集合。 (继承自 ConfigurationElement。)
ResetModified 在派生类中实现时,将 IsModified 方法的值重置为 false。 (继承自 ConfigurationElement。)
SerializeElement 当在派生类中实现后,将此配置元素的内容写入配置文件。 (继承自 ConfigurationElement。)
SerializeToXmlElement 当在派生类中实现后,将此配置元素的外部标记写入配置文件。 (继承自 ConfigurationElement。)
SetPropertyValue 将属性设置为指定值。 (继承自 ConfigurationElement。)
SetReadOnly 设置 ConfigurationElement 对象及所有子元素的 IsReadOnly 属性。 (继承自 ConfigurationElement。)
ToString 返回对象的字符串表示形式。 (重写 Object.ToString()。)
Unmerge 修改 ConfigurationElement 对象以移除所有将不被保存的值。 (继承自 ConfigurationElement。)

提示和注释

一个 ConnectionStringSettings 对象表示 connectionStrings 配置文件节中的单个项。

Topic

Location

如何:从 Web.config 文件读取连接字符串配置 ASP .NET Web 应用程序

如何:在使用数据源控件时保证连接字符串的安全 (Visual Studio)在 Visual Studio 中构建 ASP .NET Web 应用程序

如何:从 Web.config 文件读取连接字符串在 Visual Studio 中生成 ASP .NET Web 应用程序

如何:使用预设的凭据访问 SQL Server在 Visual Studio 中生成 ASP .NET Web 应用程序

如何:在使用数据源控件时保证连接字符串的安全在 Visual Studio 中生成 ASP .NET Web 应用程序

如何:从 Web.config 文件读取连接字符串在 Visual Studio 中生成 ASP .NET Web 应用程序

如何:使用预设的凭据访问 SQL Server在 Visual Studio 中生成 ASP .NET Web 应用程序

如何:在使用数据源控件时保证连接字符串的安全在 Visual Studio 中生成 ASP .NET Web 应用程序

如何:使用预设的凭据访问 SQL Server生成 ASP .NET Web 应用程序

如何:确保使用数据源控件时连接字符串的安全生成 ASP .NET Web 应用程序

System.Configuration.ConnectionStringSettings 类例子

下面的示例显示如何在 ConnectionStringSettingsCollection 集合中给定的索引处访问 ConnectionStringSettings 对象。

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Web.Configuration;
using System.Collections;
using System.Text;


namespace ConfigurationStringSettings
{

    class ConfigurationStringSettings
    {

        static void DisplayConnectionStrings()
        {
            // Set the path of the config file.
            // Make sure that you have a Web site on the
            // same server called TestConfig. 
            string configPath = "/TestConfig";

            // Get the Web application configuration object.
            Configuration config =
              WebConfigurationManager.OpenWebConfiguration(configPath);


            // Get the conectionStrings section.
            ConnectionStringsSection csSection =
                config.ConnectionStrings;

            Console.WriteLine("Display configuration strings.");

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

            }

        }


        static void Main(string[] args)
        {
            try
            {   // Display connection strings.
                DisplayConnectionStrings();
            }
            catch (Exception e)
            {
                // Unknown error.
                Console.WriteLine(e.ToString());
            }

            // Display and wait.
            Console.WriteLine("Enter any key to exit.");
            Console.ReadLine();
        }
    }
}

继承层次结构

System.Object

System.Configuration.ConfigurationElement

System.Configuration.ConnectionStringSettings

命名空间

namespace: System.Configuration

程序集: System.Configuration(在 System.Configuration.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。