大网数据广告活动
.NET 与 C# 开发

枚举 SQL Server 的实例 (ADO.NET)

· 52CE 我爱测

SQL Server 允许应用程序以查找在当前网络中的 SQL Server 实例。 类向应用程序开发人员公开此信息,提供包含所有可见服务器的信息的 。 返回表包含与匹配用户尝试创建新的连接时提供的列表并展开下拉列表包含所有可用的服务器上的网络上可用的服务器实例的列表,此连接属性对话框。 显示的结果并非总是完整的。

SQL Server 允许应用程序以查找在当前网络中的 SQL Server 实例。 xref:System.Data.Sql.SqlDataSourceEnumerator 类向应用程序开发人员公开此信息,提供包含所有可见服务器的信息的 xref:System.Data.DataTable。 返回表包含与匹配用户尝试创建新的连接时提供的列表并展开下拉列表包含所有可用的服务器上的网络上可用的服务器实例的列表,此连接属性对话框。 显示的结果并非总是完整的。

Note: 与大多数 Windows 服务一样,最好使用尽可能少的权限运行 SQL 浏览器服务。 有关 SQL 浏览器服务以及如何管理其行为的更多信息,请参见“SQL Server 联机图书”。

检索枚举器实例

要检索包含可用 SQL Server 实例信息的表,必须先使用共享/静态 xref:System.Data.Sql.SqlDataSourceEnumerator.Instance* 属性检索枚举器:

Dim instance As System.Data.Sql.SqlDataSourceEnumerator = _  
   System.Data.Sql.SqlDataSourceEnumerator.Instance  
System.Data.Sql.SqlDataSourceEnumerator instance =   
   System.Data.Sql.SqlDataSourceEnumerator.Instance  

检索到静态实例之后,可以调用 xref:System.Data.Sql.SqlDataSourceEnumerator.GetDataSources* 方法,该方法返回包含可用服务器信息的 xref:System.Data.DataTable:

Dim dataTable As System.Data.DataTable = instance.GetDataSources()  
System.Data.DataTable dataTable = instance.GetDataSources();  

通过方法调用返回的表包含以下列,所有列均包含 string 值:

列 描述
ServerName 服务器的名称。
InstanceName 服务器实例的名称。 如果服务器作为默认实例运行,则为空白。
IsClustered 指示服务器是否属于群集。
Version 服务器的版本。 例如: -9.00.x (SQL Server 2005)-10.0.xx (SQL Server 2008)-10.50.x (SQL Server 2008 R2)- 11.0.xx (SQL Server 2012)

枚举限制

所有可用服务器可能会列出,也可能不会列出。 根据超时和网络通信量等因素,列表可能会有所不同。 这可能会使两个连续调用生成不同的列表。 只会列出相同网络上的服务器。 广播包通常不会遍历路由器,这也就是可能会看不到某个服务器列出的原因,但是在各个调用之间是稳定的。

列出的服务器可能包含其他信息,也可能不包含其他信息,例如 IsClustered 和版本。 这取决于获取列表的方式。 通过 SQL Server 浏览器服务列出的服务器将比通过 Windows 基础结构发现的服务器更加详细,后者只会列出名称。

Note: 只有以完全信任模式运行时,才可以使用服务器枚举。 在部分信任的环境中运行的程序集将无法使用服务器枚举,即使这些程序集具有 xref:System.Data.SqlClient.SqlClientPermission 代码访问安全性 (CAS) 权限。

SQL Server 提供的信息xref:System.Data.Sql.SqlDataSourceEnumerator通过名为 SQL Browser 的外部 Windows 服务使用。 默认情况下启用此服务,但是管理员可以关闭或禁用此服务,使服务器实例对此类是不可见的。

示例

以下控制台应用程序检索所有可见 SQL Server 实例的信息并在控制台窗口中显示该信息。

Imports System.Data.Sql  
  
Module Module1  
  Sub Main()  
    ' Retrieve the enumerator instance and then the data.  
    Dim instance As SqlDataSourceEnumerator = _  
     SqlDataSourceEnumerator.Instance  
    Dim table As System.Data.DataTable = instance.GetDataSources()  
  
    ' Display the contents of the table.  
    DisplayData(table)  
  
    Console.WriteLine("Press any key to continue.")  
    Console.ReadKey()  
  End Sub  
  
  Private Sub DisplayData(ByVal table As DataTable)  
    For Each row As DataRow In table.Rows  
      For Each col As DataColumn In table.Columns  
        Console.WriteLine("{0} = {1}", col.ColumnName, row(col))  
      Next  
      Console.WriteLine("============================")  
    Next  
  End Sub  
End Module  
using System.Data.Sql;  
  
class Program  
{  
  static void Main()  
  {  
    // Retrieve the enumerator instance and then the data.  
    SqlDataSourceEnumerator instance =  
      SqlDataSourceEnumerator.Instance;  
    System.Data.DataTable table = instance.GetDataSources();  
  
    // Display the contents of the table.  
    DisplayData(table);  
  
    Console.WriteLine("Press any key to continue.");  
    Console.ReadKey();  
  }  
  
  private static void DisplayData(System.Data.DataTable table)  
  {  
    foreach (System.Data.DataRow row in table.Rows)  
    {  
      foreach (System.Data.DataColumn col in table.Columns)  
      {  
        Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);  
      }  
      Console.WriteLine("============================");  
    }  
  }  
}  

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。