ConnectionManager クラス

定義

名前空間:: Microsoft.SqlServer.Management.Common

アセンブリ:: Microsoft.SqlServer.ConnectionInfo.dll

パッケージ:: Microsoft.Data.Tools.Msbuild v10.0.61804.210

パッケージ:: Microsoft.Data.Tools.Msbuild v16.0.62004.28040

パッケージ:: Microsoft.SqlServer.SqlManagementObjects v150.18208.0

パッケージ:: Microsoft.SqlServer.SqlManagementObjects v160.2004021.0

パッケージ:: Microsoft.SqlServer.SqlManagementObjects v172.64.0

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

接続設定と作成

public abstract class ConnectionManager : Microsoft.SqlServer.Management.Common.ConnectionSettings

type ConnectionManager = class
    inherit ConnectionSettings

Public MustInherit Class ConnectionManager
Inherits ConnectionSettings

継承: Object

ConnectionSettings
ConnectionManager

派生: Microsoft.SqlServer.Management.Common.ServerConnection

フィールド

名前	説明
NoConnectionTimeout	無限待機 (継承元 ConnectionSettings)

プロパティ

名前	説明
AcceptsLogin	LoginSecure と Authentication の現在の値が Login プロパティを使用する場合は true を返します。 (継承元 ConnectionSettings)
AccessToken	接続設定と作成 (継承元 ConnectionSettings)
ApplicationIntent	接続の有効な値のアプリケーションの意図は、ReadWrite と ReadOnly です。 (継承元 ConnectionSettings)
ApplicationName	アプリケーションの名前。アプリケーション名が指定されていない場合は 'SQL Management' です。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
Authentication	接続の認証の種類 (継承元 ConnectionSettings)
AutoDisconnectMode	接続設定と作成
CapturedSql	接続設定と作成
ConnectAsUser	true に設定すると、指定したユーザーの資格情報を使用して接続が確立されます。これは偽装を前提としますが、LoginSecure フラグと Login フィールドと Password フィールドは影響を受けなくなります。この設定は、Windowsでのみ使用できます。 (継承元 ConnectionSettings)
ConnectAsUserName	偽装された接続を作成するときに使用するWindows ユーザーを指定します。ユーザーは対話型ログオン特権を持っている必要があります。例外: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (継承元 ConnectionSettings)
ConnectAsUserPassword	偽装された接続を作成するときに使用するWindows ユーザーのパスワードを指定します。例外: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (継承元 ConnectionSettings)
ConnectionProtocol	接続プロトコル。
ConnectionString	このプロパティは、ユーザーが指定した接続文字列を返すか、オブジェクト設定に基づいて計算された接続文字列を返します。明示的に設定すると、渡された接続文字列を反映するように ServerConnection オブジェクト内のすべてのプロパティが設定されます。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
ConnectTimeout	試行を終了して例外をスローする前に、サーバーへの接続を待機する時間 (秒単位)。既定値は 30 秒です (Shiloh と同じです)。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
CurrentDatabase	現在のデータベースコンテキストを返します。
DatabaseEngineEdition	データベースエンジンのエディション
DatabaseEngineType	SQL Serverのデータベースエンジンの種類を返します。例外: ConnectionFailureException
DatabaseName	TBD (継承元 ConnectionSettings)
EncryptConnection	接続文字列で "encrypt=true" が指定されているかどうか (継承元 ConnectionSettings)
HostNameInCertificate	証明書の検証に使用する証明書に指定されたホスト名。 (継承元 ConnectionSettings)
HostPlatform	サーバーのホストプラットフォーム (Linux/Windows/etc)
InUse	オブジェクトがサーバーに少なくとも 1 回接続されている場合は true を返します。 true の場合、プロパティの変更はそれ以上許可されず、プロパティが変更されたときに ConnectionCannotBeChangedException がスローされます。
IsContainedAuthentication	包含認証を使用してデータベースエンジンが認証を行う場合は true を返します。例外: ConnectionFailureException
IsForceDisconnected	接続が強制的に切断されたことを示します
IsOpen	SqlConnection オブジェクトがサーバーに接続されている場合は true を返します。これは、プールされた接続が操作の直後に常に閉じられるため、プールされていない接続の場合にのみ true を返すことができます。
LockTimeout	LockTimeout は、ロックタイムアウト (秒単位) です。既定の -1 は無期限です。 InvalidPropertyValueException は、他のすべての負の数値に対してスローされます。正の LockTimeout には 1000 が乗算され、"SET LOCK_TIMEOUT" 設定に使用されます。
Login	サーバーへの接続に使用するSQL Server ログイン名。例外: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (継承元 ConnectionSettings)
LoginSecure	true に設定すると、統合セキュリティWindows使用され、ログインとパスワードは無視されます。設定されていない場合は、Sql Server 認証が使用されます。例外: ConnectionCannotBeChangedException (継承元 ConnectionSettings)
MaxPoolSize	プールに格納できる最大接続数。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
MinPoolSize	プールで維持できる最小接続数。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
MultipleActiveResultSets	接続から MARS を有効にします。既定値は falseです。 (継承元 ConnectionSettings)
NetworkProtocol	SQL Serverへの接続に使用されるクライアントネットワークプロトコルを識別します。ネットワークを指定せず、ローカルサーバーを使用する場合は、共有メモリが使用されます。ネットワークを指定せず、リモートサーバーを使用する場合は、構成されているクライアントプロトコルのいずれかが使用されます。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
NonPooledConnection	既定では、SQL Serverへのすべての接続は ADO.NET 接続プールから取得されます。true に設定すると、ユーザーはプールされていない接続を作成できます (閉じたときに再利用されません)。例外: ConnectionCannotBeChangedException (継承元 ConnectionSettings)
PacketSize	SQL Server のインスタンスとの通信に使用されるネットワークパケットのサイズ (バイト単位)。既定値は 8192 です。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
Password	ログインでサーバーに接続するために使用されるパスワード。例外: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (継承元 ConnectionSettings)
PooledConnectionLifetime	プールに接続が返されると、その作成時刻が現在の時刻と比較され、その期間 (秒単位) が接続の有効期間で指定された値を超えると、接続は破棄されます。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
ProductVersion	この接続の ProductVersion サーバープロパティを取得します。
RequiresLogin	LoginSecure と認証の現在の値に Login プロパティを設定する必要がある場合は true を返します。 (継承元 ConnectionSettings)
ResetConnectionString	ConnectionManager の SqlConnectionObject プロパティで ConnectionString をリセットする必要があるかどうかを示します。 (継承元 ConnectionSettings)
SecureConnectionString	このプロパティは、ユーザーが指定した接続文字列の SecureString バージョンを返すか、オブジェクト設定に基づいて計算された接続文字列を返します。明示的に設定すると、渡された接続文字列を反映するように ServerConnection オブジェクト内のすべてのプロパティが設定されます。例外: ConnectionCannotBeChangedException (継承元 ConnectionSettings)
SecurePassword	ログインでサーバーに接続するために使用されるパスワード。例外: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (継承元 ConnectionSettings)
ServerCertificate	証明書の検証に使用するサーバー証明書のパス。 (継承元 ConnectionSettings)
ServerInstance	オブジェクトが接続するSQL Serverの名前。設定されていない場合、ローカルサーバーは暗黙的に指定されます。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)
ServerVersion	SQL Serverのメジャーバージョン番号を返します。つまり、SQL Server 2000 の場合は 8 です。例外: ConnectionFailureException
SqlConnectionObject	ConnectionContext オブジェクトによって使用される SqlConnection オブジェクトへの参照を返します。これは常に、有効な最新の ConnectionString セットを持つ有効な sqlConnection オブジェクトを返す必要があります。例外: PropertyNotAvailableException
StrictEncryption	接続文字列で "encrypt=strict" が指定されているかどうか。 true の場合、 EncryptConnection の値は無視されます。 (継承元 ConnectionSettings)
TrustServerCertificate	クライアントがサーバー証明書を信頼するかどうかを示す (継承元 ConnectionSettings)
WorkstationId	SQL Server に接続するワークステーションの名前。例外: ConnectionCannotBeChangedException InvalidPropertyValueException (継承元 ConnectionSettings)

メソッド

名前	説明
CheckServerVersion(ServerVersion)	サポートされているサーバーバージョンに接続しているかどうかを確認します。 block off <= 7.0 in ServerConnection.
Connect()	SQL Serverへの実際の接続を作成します。既に接続されている場合は無視されます。必要に応じて接続が開かれるため、このメソッドの呼び出しは省略可能です。例外: ConnectionFailureException
Disconnect()	SQL Serverを使用して接続を閉じます。既に切断されている場合は無視されます。例外: ConnectionFailureException
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	パラメーターとして渡されるアクション情報に応じて、適切なメソッドを使用して T-SQL を実行します。
ForceDisconnected()	切断を強制し、接続を再度開くことができないことを確認します
ThrowIfPropertyNotSet(String, String, Boolean)	接続設定と作成 (継承元 ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	接続設定と作成 (継承元 ConnectionSettings)
ToString()	接続設定と作成 (継承元 ConnectionSettings)

イベント

名前	説明
InfoMessage	SQL Serverが警告または情報メッセージを返したときに発生します。 SqlClient.SqlInfoMessageEventHandler を使用します。
RemoteLoginFailed	サーバーがリモートサーバーに接続する必要があり、ログインに失敗したときに呼び出されます
ServerMessage	SQL Serverが警告または情報メッセージを返したときに発生します。 SqlClient.SqlInfoMessageEventHandler を使用します。
StateChange	接続の状態が変更されたときに発生します。 System.Data.StateChangeEventHandler を使用します。
StatementExecuted	接続設定と作成

適用対象