HOW TO：在 Visual C# .NET 中将数据链接文件用于 OleDbConnection 对象

本文的发布号曾为 CHS308426

有关本文的 Microsoft Visual Basic .NET 版本，请参见 308075。
有关本文的 Microsoft Visual C++ .NET 版本，请参见 308428。

本文引用下面的 Microsoft .NET 框架类库名称空间：

• System.Data.OleDb

本任务的内容

• 概要
• • 生成示例的步骤
• 参考

概要

本文演示如何使用一个 OLE DB 通用数据链接 (.udl) 文件来指定供 ADO.NET OleDbConnection 对象用来建立数据库连接的连接字符串。

OLE DB 通用数据链接 (.udl) 文件为创建和验证用于连接到 OLE DB 数据源的 ActiveX 数据对象 (ADO) 连接字符串提供了一种方便的方法。连接字符串信息以一种特定的格式保持在一个扩展名为 .udl 的文件中。您可以在 ADO.NET OleDbConnection 对象的 ConnectionString 属性中引用一个 .udl 文件，以指定该对象连接到一个数据库时应使用的连接字符串。使用连接字符串的 File Name 参数来指定包含此连接字符串信息的 .udl 文件的名称。

注意以下信息非常重要，该信息源自 .NET 框架类库文档中的"OleDbConnection.ConnectionString 属性"文章（请参见 参考一节）：

若要引用 Microsoft Data Link (UDL)，请将对 UDL 的引用以"File Name = myfile.udl"形式添加到 ConnectionString 中。如果在连接字符串中指定了多个 UDL，则只载入最后一项。如果在指定 UDL 之后调用 OleDbConnection 对象以检索 ConnectionString，则 ConnectionString 包含对 UDL 文件的引用，而不包含文件的内容。每次打开 OleDbConnection 时都对包含 UDL 的连接字符串进行分析。因为这会影响性能，所以建议使用不引用 UDL 的 ConnectionString。

返回页首

生成示例的步骤

按照下列步骤创建一个 Visual C# .NET 控制台应用程序，该应用程序使用 .udl 文件为 ADO.NET OleDbConnection 对象指定连接字符串信息：

1. 使用 SQL Server OLE DB 提供程序连接到某个 Microsoft SQL Server 数据库，然后在 C 驱动器的根目录下创建一个名为 Test.udl 的 .udl 文件。
   
   还可使用 Microsoft OLE DB Provider for Jet 4.0 配置 .udl 文件，以便在不能访问 SQL Server 数据库时连接到 Microsoft Access 97 或 2000 数据库。有关如何创建 .udl 文件的其他信息，请单击下列文章编号，查看 Microsoft 知识库中的文章：

   189680 HOWTO: Use Data Link Files with ADO（HOWTO：将数据链接文件用于 ADO）

2. 打开新的 Visual C# .NET 控制台应用程序。
3. 将 Class1 模块中的默认代码替换为以下代码：

   using System;
   using System.Data;
   using System.Data.OleDb;
   
   namespace DataLink
   {
   class Class1
       {
   static void Main(string[] args)
           {
   OleDbConnection myConnection = new OleDbConnection("File Name = d://test.udl");
   
   try
               {
   myConnection.Open();
   if (myConnection.State == ConnectionState.Open)
   Console.WriteLine("Connection opened successfully!");
   else
   Console.WriteLine("Connection could not be established");
               }
   catch (Exception ex)
               {
   Console.WriteLine(ex.Message.ToString());
               }
   finally
               {
   myConnection.Close();
               }
   Console.ReadLine();
    
   return;
           }
       }
   }

4. 在用于设置 OleDbConnection 对象的 ConnectionString 属性的语句中，如果您用其他名称创建 .udl 文件或者将它保存到了其他位置，请修改该文件的路径。
5. 从 Visual Studio .NET 集成开发环境 (IDE) 中运行该应用程序。应打开一个控制台窗口并显示"Connection opened successfully!"（连接已成功打开！）文本，表明 OleDbConnection 对象可以使用 .udl 文件中的连接字符串信息建立数据库连接。
6. 按 ENTER 键以关闭控制台窗口并停止应用程序。

返回页首

参考

有关 OleDbConnection.ConnectionString 属性的更多信息，请参阅以下 .NET 框架类库文档：

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemDataOleDbOleDbConnectionClassConnectionStringTopic.asp

有关其他信息，请单击下列文章编号，查看 Microsoft 知识库中的文章：

189680 HOWTO: Use Data Link Files with ADO（HOWTO：将数据链接文件用于 ADO）

返回页首

这篇文章中的信息适用于:

• Microsoft ADO.NET（随 .NET 框架一起提供）
• Microsoft Visual C# .NET (2002)

最近更新:	2002-6-17 (1.0)
关键字	kbhowto kbHOWTOmaster kbOLEDB kbSystemData KB308426