如何存储和检索应用程序配置文件中的自定义信息通过使用 Visual Basic.net 或 Visual Basic 2005

文章翻译 文章翻译
文章编号: 313405 - 查看本文应用于的产品
为这篇文章的一个 Microsoft Microsoft Visual C#.net 版本,请参阅 815786
展开全部 | 关闭全部

本文内容

概要

本文演示如何将自定义信息存储在您可以以后在运行时检索其相关联的应用程序的配置 (.config) 文件。当您需要定义与应用程序相关联的数据时,这是一个很有帮助。


要求

下面的列表概述了建议的硬件、 软件、 网络的基础结构和服务包,您需要:
  • Microsoft Windows 2000、 Windows XP 或 Windows Server 2003
  • Microsoft Visual Studio.net (2002) 或 Microsoft Visual Studio.net (2003 年) 或 Microsoft Visual Studio 2005
本文假定您熟悉下列主题:
  • 可扩展标记语言 (XML)
  • .NET 配置文件

创建控制台应用程序读取的配置文件的内容,

您可以将存储在配置文件中与该应用程序相关联的应用程序设置。配置文件都保存在 XML 中的格式。System.Configuration 和 Microsoft.net 框架中的 System.Collections.Specialized 命名空间包括从.net 应用程序配置文件中检索信息,在运行时所需的类。

若要进行一个控制台应用程序,它在运行时读取一个关联的配置文件的内容,请按照下列步骤操作:
  1. 启动 Visual Studio.net 或 Visual Studio 2005。
  2. 创建名为 ConConfig Visual Basic.net 或 Visual Basic 2005 中的新的控制台应用程序项目。Visual Basic.net 或 Visual Basic 2005 创建默认情况下命名为模块 1 模块。
  3. 用鼠标右键单击该 ConConfig 项目 文件夹,指向 添加,然后单击 添加新项

    注意在 Visual 有关 Studio 的 2005 年用鼠标右键单击该 ConConfig 项目 指向 添加,然后单击 新项 文件夹。
  4. 添加新项 对话框中选择 应用程序配置文件 模板,单击 打开,然后添加到项目的 App.config 文件。

    注意Visual Studio.net 或 Visual Studio 2005 IDE 将 App.Config 复制到文件夹位置可执行文件已被编译,并将它重命名 <ApplicationName><Application Type>.config 格式。
  5. 您可以使用应用程序配置文件来收集将保存为键/值格式的自定义应用程序设置。您可以包括 <add><appsettings>中的元素 一个关联的配置文件的部分。每个键/值对都有一个 <add> 元素。一个 <add> 元素具有以下格式:
    <add key="theKey" value="theValue" />
    						
    添加一个 <appsettings><add>节 到配置文件 <configuration>和</configuration> 标记之间的元素。例如对于下面的配置文件包括一个<appsettings> 部分中,指定三个键/值对:
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
    	<appSettings>
    		<add key="Key0" value="0" />
    		<add key="Key1" value="1" />
    		<add key="Key2" value="2" />
    	</appSettings>
    </configuration>
    					
  6. 在解决方案资源管理器中,双击 Module1.vb 以显示模块 1 的代码窗口。将以下语句添加到您的代码模块中:

    注意这些语句必须出现在任何其他语句中的之前文件。
    Imports System.Configuration
    Imports System.Collections.Specialized
    					
  7. Sub Main 过程中维度中该 <appsettings>保存从配置文件注册表项值的字符串变量 配置文件节:
    Dim sAttr As String
    					
  8. 若要从该 <appsettings>检索指定的项的值 部分中配置文件的使用 AppSettingsConfigurationSettings 类的方法。ConfigurationSettings 类是 System.Configuration 命名空间中。当 AppSettings 方法接收一个字符串输入的参数包含一个密钥时,应用程序将检索与密钥关联的值。

    下面的代码从关联的配置文件中检索 Key0 属性的值。该代码然后将此值放在字符串变量的 sAttr。如果此值不存在密钥,Nothing 存储在 sAttr
    sAttr = ConfigurationSettings. AppSettings("Key0")
    					
  9. 若要显示在控制台窗口中的应用程序检索的值,使用 Console.WriteLine
    Console.WriteLine("The value of Key0: " & sAttr)
    					
  10. 可用于检索所有的键/值对,在该 <appsettings>AppSettings 属性的一个引用 部分。如果使用 AppSettings 属性时,您不指定任何参数,应用程序将返回所有相关联的键/值对。 这些对存储在一个包含应用程序检索每个键的键/值条目的 NameValueCollection 类型。NameValueCollection 类处于
    Dim sAll As NameValueCollection
    sAll = ConfigurationSettings.AppSettings()
    					
    System.Collections.Specialized 命名空间。
  11. NameValueCollectionAllKeys 属性引用一个字符串数组,包含应用程序检索每个键的项。使用 For Next 构造来循环访问每个应用程序检索的键 AllKeys 数组。AllKeys 中的每一键的项是一个字符串 data type.
    Dim s As String
    For Each s In sAll.AllKeys
    					
  12. For Each 构造内使用 Console.WriteLine 键和它的关联的值显示在控制台窗口。应用程序处理的当前项处于"s。将此用作 sAllNameValueCollection 中的索引来获取它的关联的值。

    例如对于如果应用程序处理 Key0 键,sAll("Key0") 将检索其相关联的值。Console.Readline 语句暂停控制台。您可以按下 ENTER 结束该应用程序
        Console.WriteLine("Key: " & s & " Value: " & sAll(s))
    Next
    Console.Readline
    					

验证它工作的

按 F5 键运行该代码。控制台窗口应该显示键/值对,从该 <appsettings> 一部分关联的配置文件,如下所示:
The value of Key0: 0
Key: Key0 Value:0
Key: Key1 Value:1
Key: Key2 Value:2
					

完成代码列表

Imports System.Configuration
Imports System.Collections.Specialized

Module Module1

    Sub Main()
        Dim sAttr As String

        sAttr = ConfigurationSettings.AppSettings("Key0")
        Console.WriteLine("The value of Key0: " & sAttr)
        
        Dim sAll As NameValueCollection
        sAll = ConfigurationSettings.AppSettings()

        Dim s As String
        For Each s In sAll.AllKeys
            Console.WriteLine("Key: " & s & " Value: " & sAll(s))
        Next
		  Console.ReadLine()
    End Sub

End Module
				

完成列表 (ConConfig.exe.config) 的配置文件

<configuration>
	<appSettings>
		<add key="Key0" value="0"/>
		<add key="Key1" value="1"/>
		<add key="Key2" value="2"/>
	</appSettings>
</configuration>
				

故障排除

  • 配置文件将以 XML 格式保存。请确保您遵守所有 XML 语法规则。请记住 XML 是区分大小写。如果 XML 的格式不正确,或者元素的拼写错误收到 System.Configuration.Configuration 异常。

    例如您添加的一个 <add>键属性 具有一个大写"K"的大小写"k,而不是元素或如果该 <appsettings> 部分将显示为 <appsettings> (而不是一个小写的一个大写字母"A"与"a"),您收到一条错误消息。
  • 配置文件必须包含在项目中。
  • 文件创建 Visual Studio 环境之外,它必须驻留在其相关联的应用程序所在的文件夹中时,您必须输入配置文件的名称中使用以下语法:
    ApplicationNameApplicationType.config
    其中 ApplicationNameApplicationType 应用程序的名称是应用程序 (例如对于 exe) 的类型和.config 是必需的后缀。

参考

有关详细的信息,请访问以下 MSDN 网站:
ConfigurationSettings.AppSettings 属性
http://msdn2.microsoft.com/en-us/library/system.configuration.configurationsettings.appsettings(vs.71).aspx
System.Configuration 命名空间
http://msdn2.microsoft.com/en-us/library/system.configuration(vs.71).aspx

属性

文章编号: 313405 - 最后修改: 2006年12月6日 - 修订: 5.5
这篇文章中的信息适用于:
  • Microsoft Visual Basic 2005
  • Microsoft Visual Basic .NET 2003 标准版
  • Microsoft Visual .NET 2002 标准版
关键字:?
kbmt kbvs2005swept kbvs2005applies kbconfig kbhowtomaster KB313405 KbMtzh
机器翻译
注意:这篇文章是由无人工介入的微软自动的机器翻译软件翻译完成。微软很高兴能同时提供给您由人工翻译的和由机器翻译的文章, 以使您能使用您的语言访问所有的知识库文章。然而由机器翻译的文章并不总是完美的。它可能存在词汇,语法或文法的问题,就像是一个外国人在说中文时总是可能犯这样的错误。虽然我们经常升级机器翻译软件以提高翻译质量,但是我们不保证机器翻译的正确度,也不对由于内容的误译或者客户对它的错误使用所引起的任何直接的, 或间接的可能的问题负责。
点击这里察看该文章的英文版: 313405
Microsoft和/或其各供应商对于为任何目的而在本服务器上发布的文件及有关图形所含信息的适用性,不作任何声明。 所有该等文件及有关图形均"依样"提供,而不带任何性质的保证。Microsoft和/或其各供应商特此声明,对所有与该等信息有关的保证和条件不负任何责任,该等保证和条件包括关于适销性、符合特定用途、所有权和非侵权的所有默示保证和条件。在任何情况下,在由于使用或运行本服务器上的信息所引起的或与该等使用或运行有关的诉讼中,Microsoft和/或其各供应商就因丧失使用、数据或利润所导致的任何特别的、间接的、衍生性的损害或任何因使用而丧失所导致的之损害、数据或利润不负任何责任。

提供反馈

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com