次の方法で共有

SmoApplication.EnumAvailableSqlServers Method (String)

  • [アーティクル]

コンピュータにインストールされている Microsoft SQL Server の利用可能なインスタンスの中で、指定したインスタンス名があるインスタンスの一覧を列挙します。

名前空間: Microsoft.SqlServer.Management.Smo
アセンブリ: Microsoft.SqlServer.Smo (microsoft.sqlserver.smo.dll 内)

構文

'宣言
Public Shared Function EnumAvailableSqlServers ( _
    name As String _
) As DataTable

public static DataTable EnumAvailableSqlServers (
    string name
)

public:
static DataTable^ EnumAvailableSqlServers (
    String^ name
)

public static DataTable EnumAvailableSqlServers (
    String name
)

public static function EnumAvailableSqlServers (
    name : String
) : DataTable

パラメータ

  • name
    SQL Server のインスタンスがインストールされているコンピュータまたは SQL Server の単一のインスタンスの名前を指定するString 値です。

戻り値

指定したコンピュータ上の SQL Server の利用可能なインスタンスに関する情報を列挙した一覧を含む DataTable システム オブジェクトの値です。 name パラメータにコンピュータ名ではなく SQL Server の単一のインスタンスを指定している場合、指定したインスタンスの結果だけが返されます。次の表に、返される DataTable の列を示します。

列

データ型

説明

Name

String

SQL Server のインスタンスの名前です。

Server

String

SQL Server のインスタンスがインストールされているサーバーの名前です。

Instance

String

SQL Server のインスタンスです。

IsClustered

Boolean

インスタンスがフェールオーバー クラスタリングに参加している場合は True、参加していない場合は False となるブール値です。

Version

String

SQL Server のインスタンスのバージョンです。

IsLocal

Boolean

インスタンスがローカルの場合は True、リモートの場合は False となるブール値です。

解説

更新されたテキスト :

SQL Server のインスタンスを実行しているコンピュータは、EnumAvailableSqlServers メソッドへの応答を適切なタイミングで受信できないことがあります。返される一覧には、ネットワーク上の SQL Server の利用可能なインスタンスが一部表示されない場合があります。また後続の試行で EnumAvailableSqlServers メソッドを呼び出すと、ネットワークで表示されるサーバーの数が増える場合があります。

サーバーでファイアウォールが動作している場合は、このメソッドでローカル インスタンスを一覧表示できません。ファイアウォールは、送信元がローカル コンピュータであっても、メソッドの呼び出し時に発行されるすべてのブロードキャスト トラフィックをブロックします。

この名前空間、クラス、またはメンバは、Microsoft .NET Framework Version 2.0 でのみサポートされています。

使用例

Visual Basic .NET でイベント ハンドラの登録およびイベント ハンドリングのサブスクライブを行う方法

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

SmoApplication Class
SmoApplication Members
Microsoft.SqlServer.Management.Smo Namespace

その他の技術情報

SMO イベントの処理

変更履歴

リリース

履歴
新しい内容 :

  • ローカル インスタンスの場合、ファイアウォールがこのメソッドにどのように干渉するかについての記述を追加しました。

新しい内容 :

  • メソッドから DataTable 型に返される列を示す表を追加しました。