SqlDataSourceEnumerator.GetDataSources メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
参照できる SQL Server のインスタンスに関する情報が格納された DataTable を取得します。
public:
override System::Data::DataTable ^ GetDataSources();
public override System.Data.DataTable GetDataSources ();
override this.GetDataSources : unit -> System.Data.DataTable
Public Overrides Function GetDataSources () As DataTable
戻り値
参照できる SQL Server のインスタンスに関する情報が格納された DataTable。
例
次のコンソール アプリケーションは、表示されているすべてのSQL Server インスタンスに関する情報を取得し、コンソール ウィンドウに情報を表示します。
using Microsoft.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("============================");
}
}
}
注釈
このメソッドによって返されるテーブルには次の列が含まれており、そのすべてが文字列を含みます。
Column | 説明 |
---|---|
ServerName | サーバーの名前。 |
InstanceName | サーバー インスタンスの名前。 サーバーが既定のインスタンスとして実行されている場合は空白です。 |
IsClustered | サーバーがクラスターの一部であるかどうかを示します。 |
Version | サーバーのバージョン: SQL Server 2008 の場合は 10.0.xx SQL Server 2008 R2 の場合は 10.50.x SQL Server 2012 の場合は 11.0.xx SQL Server 2014 の場合は 12.0.xx SQL Server 2016 の場合は 13.0.xx SQL Server 2017 の場合は 14.0.xx |
注意
ネットワーク上のデータ ソースを検索するために によって SqlDataSourceEnumerator 使用されるメカニズムの性質上、メソッドは常に使用可能なサーバーの完全なリストを返すとは限りません。また、呼び出しごとにリストが同じではない可能性があります。 この関数を使用してユーザーが一覧からサーバーを選択できるようにする場合は、サーバー列挙で使用可能なすべてのサーバーが返されない場合に備えて、リストにない名前を入力するオプションも常に指定してください。 さらに、このメソッドの実行にはかなりの時間がかかる場合があるため、パフォーマンスが重要な場合は呼び出しに注意してください。