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 インスタンスに関する情報を取得し、コンソール ウィンドウに情報を表示します。
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("============================");
}
}
}
注釈
このメソッドによって返されるテーブルには、次の列が含まれており、そのすべてが文字列を含みます。
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 使用されるメカニズムの性質上、 メソッドは常に使用可能なサーバーの完全な一覧を返すとは限りません。また、呼び出しのたびに一覧が同じとは限りません。 この関数を使用してユーザーが一覧からサーバーを選択できるようにする場合は、サーバー列挙で使用可能なすべてのサーバーが返されない場合に備えて、リストにない名前を入力するオプションも常に指定してください。 さらに、このメソッドの実行にはかなりの時間がかかる場合があるため、パフォーマンスが重要な場合は呼び出しに注意してください。
適用対象
こちらもご覧ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET