SqlDataSourceEnumerator.GetDataSources メソッド

.NET Framework クラス ライブラリ リファレンス

SqlDataSourceEnumerator.GetDataSources メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

参照できるすべての SQL Server 2000 インスタンスまたは SQL Server 2005 インスタンスに関する情報が格納された DataTable を取得します。

名前空間: System.Data.Sql
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetDataSources As DataTable

Visual Basic (使用法)

Dim instance As SqlDataSourceEnumerator
Dim returnValue As DataTable

returnValue = instance.GetDataSources

C#

public override DataTable GetDataSources ()

C++

public:
virtual DataTable^ GetDataSources () override

J#

public DataTable GetDataSources ()

JScript

public override function GetDataSources ()
 : DataTable

戻り値
参照できる SQL Server のインスタンスに関する情報が格納された DataTable を返します。

解説

このメソッドで返されるテーブルには、次の列が含まれます。すべての列には文字列が格納されます。

列	説明
ServerName	サーバーの名前。
InstanceName	サーバー インスタンスの名前。サーバーが既定のインスタンスで実行されている場合は空白。
IsClustered	サーバーがクラスタの一部かどうかを示します。
バージョン	サーバーのバージョン (SQL Server 2000 の場合は 8.00.x、SQL Server 2005 の場合は 9.00.x)。

メモ
ネットワーク上のデータ ソースを探すために SqlDataSourceEnumerator によって使用される機構の性質により、このメソッドは利用できるサーバーの完全な一覧を常に返すとは限りません。また、すべての呼び出しで同じ一覧が返されるとも限りません。この関数を使用して、ユーザーが、一覧からサーバーを選択するようにする場合は、利用できるすべてのサーバーがサーバーの一覧表示に返されていない場合に、一覧にない名前を入力するためのオプションも、常に用意するようにしてください。また、このメソッドは実行にかなりの時間がかかることがあるため、パフォーマンスが重要な場合、このメソッドの呼び出しについては注意が必要です。

使用例

次のコンソール アプリケーションは、参照できる SQL Server のインスタンスに関する情報を取得し、その情報をコンソール ウィンドウに表示します。

Visual Basic

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

C#

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("============================");
    }
  }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlDataSourceEnumerator クラス
SqlDataSourceEnumerator メンバ
System.Data.Sql 名前空間
その他の技術情報
SQL Server のインスタンスの列挙