ServerConnection Class

ServerConnection オブジェクトは、サーバーへの接続を表します。

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

構文

'宣言
Public NotInheritable Class ServerConnection
    Inherits ConnectionManager
public sealed class ServerConnection : ConnectionManager
public ref class ServerConnection sealed : public ConnectionManager
public final class ServerConnection extends ConnectionManager
public final class ServerConnection extends ConnectionManager

解説

更新されたテキスト :

ServerConnection クラスは、Server クラス、および ReplicationServer クラスなどのレプリケーション クラスによって処理されます。

ServerConnection オブジェクトのインスタンスは通常、サーバー オブジェクトを使用して自動的に作成されるので、宣言する必要はありません。接続設定を再利用できるように保存する場合は、ServerConnection オブジェクト変数を宣言します。サーバー オブジェクトの ConnectionContext プロパティは、ServerConnection オブジェクトを指します。ServerConnection オブジェクトには、サーバー オブジェクトと SQL Server のインスタンス間の接続に関連するプロパティが含まれています。プロセス ID、処理中のトランザクション、認証モード、実行モードなどの特定の接続設定を表示または変更したり、Transact-SQL コマンドを直接実行したりするために使用できます。

ServerConnection オブジェクトを使用すると、次のような操作を実行できます。

  • SQL Server のインスタンスへの接続に対して Transact-SQL ステートメントを直接実行する。

  • 認証方法などの接続設定を変更する。

  • トランザクションを開始し、コミットしてロールバックする。

  • SMO アプリケーションによって生成された Transact-SQL ステートメントをキャプチャする。

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

継承階層

System.Object
   Microsoft.SqlServer.Management.Common.ConnectionSettings
     Microsoft.SqlServer.Management.Common.ConnectionManager
      Microsoft.SqlServer.Management.Common.ServerConnection

使用例

Database オブジェクトを使用したこのメソッドの他の例については、「ExecuteNonQuery」を参照してください。

'Declare a ServerConnection object variable to specify SQL authentication, login and password.
Dim conn As New ServerConnection
conn.LoginSecure = False
conn.Login = vlogin
conn.Password = vpassword
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server(conn)
'The actual connection is made when a property is retrieved.
Console.WriteLine(srv.Information.Version)
'The connection is automatically disconnected when the Server variable goes out of scope.

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

ServerConnection Members
Microsoft.SqlServer.Management.Common Namespace

その他の技術情報

Visual Basic .NET で Windows 認証を使用して SQL Server のローカル インスタンスに接続する方法
SQL Server のインスタンスへの接続

変更履歴

リリース

履歴

変更内容 :
  • ServerConnection クラスの説明を追加しました。

  • 「例」セクションにコード例を追加しました。

  • ExecuteNonQuery メソッドと ChangePassword メソッドにオーバーロードを追加しました。