ServerConnection 클래스

정의

네임스페이스:

Microsoft.SqlServer.Management.Common

어셈블리:

Microsoft.SqlServer.ConnectionInfo.dll

패키지:

Microsoft.SqlServer.SqlManagementObjects v172.64.0

public sealed class ServerConnection : Microsoft.SqlServer.Management.Common.ConnectionManager, Microsoft.SqlServer.Management.Common.ISfcConnection

type ServerConnection = class
    inherit ConnectionManager
    interface ISfcConnection

Public NotInheritable Class ServerConnection
Inherits ConnectionManager
Implements ISfcConnection

상속

Object

ConnectionSettings

ConnectionManager

ServerConnection

구현

ISfcConnection

생성자

Name	Description
ServerConnection()
ServerConnection(IRenewableToken)	토큰을 가져오는 ServerConnection 개체를 만듭니다. 추가 부울은 문자열이 있는 다른 생성자가 있으므로 이 생성자를 오버로드하는 데 사용됩니다.
ServerConnection(SqlConnection, IRenewableToken)	새 ServerConnection 개체를 생성합니다.
ServerConnection(SqlConnection)	지정된 SqlConnection에서 새 ServerConnection 개체를 생성합니다.
ServerConnection(SqlConnectionInfo)
ServerConnection(String, String, SecureString)
ServerConnection(String, String, String)
ServerConnection(String)

필드

Name	Description
NoConnectionTimeout	무한 대기 (다음에서 상속됨 ConnectionSettings)

속성

Name	Description
AcceptsLogin	LoginSecure 및 인증에 대한 현재 값이 로그인 속성을 사용하는 경우 true를 반환합니다. (다음에서 상속됨 ConnectionSettings)
AccessToken	(다음에서 상속됨 ConnectionSettings)
ApplicationIntent	연결 유효한 값의 애플리케이션 의도는 ReadWrite 및 ReadOnly입니다. (다음에서 상속됨 ConnectionSettings)
ApplicationName	애플리케이션의 이름입니다. 애플리케이션 이름이 제공되지 않은 경우 'SQL Management'입니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException (다음에서 상속됨 ConnectionSettings)
Authentication	연결의 인증 유형 (다음에서 상속됨 ConnectionSettings)
AutoDisconnectMode	(다음에서 상속됨 ConnectionManager)
BatchSeparator	ExecuteNonQuery 메서드에서 사용하는 일괄 처리 구분 기호를 정의합니다. 기본값은 "GO"입니다. 일괄 처리 구분 기호는 대/소문자를 구분하지 않습니다.
CachedQueries	ServerConnection 인스턴스가 쿼리 결과를 캐시해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
CapturedSql	(다음에서 상속됨 ConnectionManager)
ConnectAsUser	true로 설정하면 지정된 사용자의 자격 증명으로 연결됩니다. 이는 가장을 가정합니다. 그러나 LoginSecure 플래그 및 로그인 및 암호 필드는 영향을 받지 않습니다. 이 설정은 Windows 경우에만 사용할 수 있습니다. (다음에서 상속됨 ConnectionSettings)
ConnectAsUserName	가장된 연결을 만들 때 사용되는 Windows 사용자를 지정합니다. 사용자에게 대화형 로그온 권한이 있어야 합니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (다음에서 상속됨 ConnectionSettings)
ConnectAsUserPassword	가장된 연결을 만들 때 사용되는 Windows 사용자의 암호를 지정합니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (다음에서 상속됨 ConnectionSettings)
ConnectionProtocol	연결 프로토콜입니다. (다음에서 상속됨 ConnectionManager)
ConnectionString	이 속성은 사용자가 지정한 연결 문자열 반환하거나 개체 설정에 따라 계산된 연결 문자열 반환합니다. 명시적으로 설정하면 전달된 연결 문자열 반영하도록 ServerConnection 개체의 모든 속성이 채워집니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException (다음에서 상속됨 ConnectionSettings)
ConnectionType
ConnectTimeout	시도를 종료하고 예외를 throw하기 전에 서버에 대한 연결을 기다리는 시간(초)입니다. 기본값은 30초(실로와 동일)입니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException (다음에서 상속됨 ConnectionSettings)
CurrentDatabase	현재 데이터베이스 컨텍스트를 반환합니다. (다음에서 상속됨 ConnectionManager)
DatabaseEngineEdition	데이터베이스 엔진 버전 (다음에서 상속됨 ConnectionManager)
DatabaseEngineType	SQL Server 데이터베이스 엔진 유형을 반환합니다. 예외: ConnectionFailureException (다음에서 상속됨 ConnectionManager)
DatabaseName	TBD (다음에서 상속됨 ConnectionSettings)
EncryptConnection	연결 문자열 "encrypt=true"가 지정되었는지 여부 (다음에서 상속됨 ConnectionSettings)
FixedServerRoles	로그인이 멤버인 고정 서버 역할을 지정한 열거형을 반환합니다.
HostNameInCertificate	인증서 유효성 검사에 사용할 인증서에 제공된 호스트 이름입니다. (다음에서 상속됨 ConnectionSettings)
HostPlatform	서버의 호스트 플랫폼(Linux/Windows/etc) (다음에서 상속됨 ConnectionManager)
InUse	개체가 서버에 한 번 이상 연결된 경우 true를 반환합니다. true이면 속성 변경이 더 이상 허용되지 않으며 속성이 변경되면 ConnectionCannotBeChangedException이 throw됩니다. (다음에서 상속됨 ConnectionManager)
IsContainedAuthentication	데이터베이스 엔진이 포함된 인증을 사용하여 인증하는 경우 true를 반환합니다. 예외: ConnectionFailureException (다음에서 상속됨 ConnectionManager)
IsForceDisconnected	연결이 강제로 끊어졌는지 나타냅니다. (다음에서 상속됨 ConnectionManager)
IsOpen	SqlConnection 개체가 서버와 연결된 경우 true를 반환합니다. 풀된 연결은 작업 후 직접 항상 닫혀 있으므로 풀되지 않은 연결에 대해서만 true를 반환할 수 있습니다. (다음에서 상속됨 ConnectionManager)
LockTimeout	LockTimeout은 잠금 시간 제한(초)입니다. 기본 -1 무기한입니다. 다른 모든 음수에 대해 InvalidPropertyValueException이 throw됩니다. Positive LockTimeout은 1000을 곱한 다음 "SET LOCK_TIMEOUT" 설정에 사용됩니다. (다음에서 상속됨 ConnectionManager)
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)
ParameterizationMode	모든 ServerConnection 인스턴스에서 QueryParameterizationMode 사용하는 QueryParameterizationMode를 나타내는 값을 가져오거나 설정합니다.
Password	로그인과 함께 서버에 연결하는 데 사용되는 암호입니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException PropertyNotSetException (다음에서 상속됨 ConnectionSettings)
PooledConnectionLifetime	연결이 풀에 반환되면 생성 시간이 현재 시간과 비교되고 해당 시간 범위(초)가 연결 수명에서 지정한 값을 초과하면 연결이 제거됩니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException (다음에서 상속됨 ConnectionSettings)
ProcessID	ProcessID 속성은 ServerConnection 개체에서 사용하는 연결에 대한 SQL Server 프로세스 식별자를 반환합니다.
ProductVersion	이 연결의 ProductVersion 서버 속성을 가져옵니다. (다음에서 상속됨 ConnectionManager)
RequiresLogin	LoginSecure 및 인증의 현재 값에 로그인 속성을 설정해야 하는 경우 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 주 버전 번호를 반환합니다. 즉, 2000년 SQL Server 8입니다. 예외: ConnectionFailureException (다음에서 상속됨 ConnectionManager)
SqlConnectionObject	ConnectionContext 개체에서 사용하는 SqlConnection 개체에 대한 참조를 반환합니다. 항상 유효한 최신 ConnectionString 집합이 있는 유효한 sqlConnection 개체를 반환해야 합니다. 예외: PropertyNotAvailableException (다음에서 상속됨 ConnectionManager)
SqlExecutionModes	SQL 문이 캡처되거나 서버로 전송되는지 확인합니다.
StatementTimeout	문이 실패하기 전에 서버로 보내려고 시도하는 시간(초)입니다. 기본값은 600초입니다(실로와 동일). 예외: InvalidPropertyValueException
StrictEncryption	연결 문자열 "encrypt=strict"가 지정되었는지 여부입니다. true이면 값 EncryptConnection 이 무시됩니다. (다음에서 상속됨 ConnectionSettings)
TransactionDepth	개체 모델에서 계산하는 트랜잭션 깊이를 제공합니다. 서버에서 시작되었거나 ExecuteNonQuery 메서드를 사용하여 BEGIN TRAN을 실행하여 시작된 트랜잭션은 포함되지 않습니다.
TrueLogin	TrueLogin 속성은 현재 연결에서 사용하는 로그인 레코드 이름을 반환합니다.
TrueName	TrueName 속성은 Microsoft SQL Server ® 전역 함수 @@INSTANCENAME 결과 집합을 반환합니다.
TrustServerCertificate	클라이언트가 서버 인증서를 신뢰하는지 여부를 나타냅니다. (다음에서 상속됨 ConnectionSettings)
UseMode	모든 ServerConnection 인스턴스에서 DeferredUseMode 사용하는 UseMode를 가져오거나 설정합니다.
UserProfile	UserProfile 속성은 현재 연결에서 사용하는 Microsoft SQL Server 로그인에 대한 높은 수준의 역할 설명을 반환합니다.
WorkstationId	SQL Server에 연결하는 워크스테이션의 이름입니다. 예외: ConnectionCannotBeChangedException InvalidPropertyValueException (다음에서 상속됨 ConnectionSettings)

메서드

Name	Description
BeginTransaction()	새 트랜잭션을 시작합니다. CaptureMode가 true이면 트랜잭션 문이 캡처 버퍼에 추가됩니다. 트랜잭션을 중첩할 수 있습니다. 열려 있는 모든 트랜잭션을 커밋하거나 롤백하는 것은 사용자의 책임입니다. 개체 모델에서 내보낸 모든 T-SQL이 트랜잭션에 의해 캡슐화될 수 있다고 보장되지는 않습니다. 또한 트랜잭션이 커밋되거나 트랜잭션이 롤백된 후에 변경된 개체의 상태는 실제 데이터베이스 상태를 반영하지 않습니다. 영향을 받는 개체를 새로 고치는 것은 사용자의 책임입니다. 주의하여 사용하세요.
Cancel()
ChangePassword(SecureString)
ChangePassword(String)
CheckServerVersion(ServerVersion)	지원되는 서버 버전에 연결하고 있는지 확인합니다. Block off <= ServerConnection에서 7.0입니다. (다음에서 상속됨 ConnectionManager)
CommitTransaction()	트랜잭션을 커밋합니다. CaptureMode가 true이면 트랜잭션 명령이 캡처 버퍼에 추가됩니다. 예외: NotInTransactionException
Connect()	SQL Server 대한 실제 연결을 만듭니다. 이미 연결된 경우 무시됩니다. 필요한 경우 연결이 열리기 때문에 이 메서드를 호출하는 것은 선택 사항입니다. 예외: ConnectionFailureException (다음에서 상속됨 ConnectionManager)
Copy()	이 함수는 딥 카피를 수행합니다.
Disconnect()	SQL Server 연결을 닫습니다. 이미 연결이 끊긴 경우 무시됩니다. 예외: ConnectionFailureException (다음에서 상속됨 ConnectionManager)
ExecuteNonQuery(String, ExecutionTypes, Boolean)	T-SQL 문을 실행합니다. 명령 용어('GO')는 ExecuteNonQuery에서 인식됩니다. 일괄 처리는 개별적으로 전송 및 실행됩니다. CaptureMode가 true로 설정된 경우 문이 기록되고 실행되지 않습니다. 영향을 받는 행 수를 포함하는 int 값이 반환됩니다. 여러 일괄 처리가 실행되면 모든 일괄 처리의 영향을 받는 행의 총 수가 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(String, ExecutionTypes)	T-SQL 문을 실행합니다. 명령 용어('GO')는 ExecuteNonQuery에서 인식됩니다. 일괄 처리는 개별적으로 전송 및 실행됩니다. CaptureMode가 true로 설정된 경우 문이 기록되고 실행되지 않습니다. 영향을 받는 행 수를 포함하는 int 값이 반환됩니다. 여러 일괄 처리가 실행되면 모든 일괄 처리의 영향을 받는 행의 총 수가 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(String)
ExecuteNonQuery(StringCollection, ExecutionTypes, Boolean)	StringCollection에서 T-SQL 문을 실행합니다. 명령 용어('GO')는 ExecuteNonQuery에서 인식됩니다. GO 문으로 구분된 일괄 처리는 개별적으로 전송되고 실행됩니다. CaptureMode가 true로 설정된 경우 문이 기록되고 실행되지 않습니다. StringCollection의 각 문에 영향을 받는 행 수를 포함하는 int 값 배열이 반환됩니다. 여러 일괄 처리가 실행되면 모든 일괄 처리의 영향을 받는 행의 총 수가 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(StringCollection, ExecutionTypes)	StringCollection에서 T-SQL 문을 실행합니다. 명령 용어('GO')는 ExecuteNonQuery에서 인식됩니다. GO 문으로 구분된 일괄 처리는 개별적으로 전송되고 실행됩니다. CaptureMode가 true로 설정된 경우 문이 기록되고 실행되지 않습니다. StringCollection의 각 문에 영향을 받는 행 수를 포함하는 int 값 배열이 반환됩니다. 여러 일괄 처리가 실행되면 모든 일괄 처리의 영향을 받는 행의 총 수가 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteNonQuery(StringCollection)
ExecuteReader(String, SqlCommand)	T-SQL 문을 실행합니다. SQL Server 반환되는 행 스트림을 읽는 데 사용할 수 있는 SqlDataReader 개체가 반환됩니다. 장기 실행 쿼리의 중단이 필요한 경우 데이터 판독기 파이프를 취소하는 데 사용할 수 있는 SqlCommand 개체도 반환됩니다. 예외의 연결을 자동으로 끊지 않습니다. ConnectionFailureException ExecutionFailureExeception
ExecuteReader(String)	T-SQL 문을 실행합니다. SQL Server 반환되는 행 스트림을 읽는 데 사용할 수 있는 SqlDataReader 개체가 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외의 연결을 자동으로 끊지 않습니다. ConnectionFailureException ExecutionFailureExeception
ExecuteScalar(String)	T-SQL 문을 실행합니다. 결과 집합의 첫 번째 행에 있는 첫 번째 열을 포함하는 개체가 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteScalar(StringCollection)	StringCollection에서 T-SQL 문을 실행합니다. 실행된 각 문에 대한 결과 집합의 첫 번째 행에 대한 첫 번째 열이 각각 포함된 개체 배열이 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteTSql(ConnectionManager+ExecuteTSqlAction, Object, DataSet, Boolean)	매개 변수로 전달된 작업 정보에 따라 적절한 메서드를 사용하여 T-SQL을 실행합니다. (다음에서 상속됨 ConnectionManager)
ExecuteWithResults(String, Boolean)	sqlCommand에서 T-SQL 문을 실행합니다. 결과를 포함하는 DataSet이 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteWithResults(String)	sqlCommand에서 T-SQL 문을 실행합니다. 결과를 포함하는 DataSet이 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ExecuteWithResults(StringCollection)	StringCollection에서 T-SQL 문을 실행합니다. StringCollection의 각 문에 대한 결과를 포함하는 DataSets 배열이 반환됩니다. 서버와의 연결이 열려 있지 않으면 Connect() 메서드가 호출됩니다. 예외: ConnectionFailureException ExecutionFailureExeception
ForceDisconnected()	연결을 끊고 연결을 다시 열 수 없도록 합니다. (다음에서 상속됨 ConnectionManager)
GetDatabaseConnection(String, Boolean, IRenewableToken)	연결 문자열 지정된 데이터베이스 이름이 있는 연결을 반환합니다. 현재 연결이 지정된 데이터베이스를 이미 참조하는 경우 현재 연결이 반환됩니다.
GetDatabaseConnection(String, Boolean)	연결 문자열 지정된 데이터베이스 이름이 있는 연결을 반환합니다. 현재 연결이 지정된 데이터베이스를 이미 참조하는 경우 현재 연결이 반환됩니다.
IsInFixedServerRole(FixedServerRoles)	로그인이 지정된 서버 역할의 멤버인지 테스트합니다.
NormalizeQuery(String, Boolean)	포함된 리터럴이 있는 쿼리를 정규화된 형식(모든 리터럴이 표준 토큰으로 대체됨)으로 변환
NormalizeQuery(String)	위의 함수에 대한 오버로드 -- 자세한 내용은 참조하세요.
RollBackTransaction()	트랜잭션을 중단합니다(변경한 모든 내용은 데이터베이스에 저장되지 않음). CaptureMode가 true이면 트랜잭션 명령이 캡처 버퍼에 추가됩니다. 예외: NotInTransactionException
ThrowIfPropertyNotSet(String, String, Boolean)	(다음에서 상속됨 ConnectionSettings)
ThrowIfPropertyNotSet(String, String)	(다음에서 상속됨 ConnectionSettings)
ToString()	(다음에서 상속됨 ConnectionSettings)

이벤트

Name	Description
InfoMessage	SQL Server 경고 또는 정보 메시지를 반환할 때 발생합니다. SqlClient.SqlInfoMessageEventHandler를 사용합니다. (다음에서 상속됨 ConnectionManager)
RemoteLoginFailed	서버가 원격 서버에 연결해야 하고 로그인이 실패할 때 호출됩니다. (다음에서 상속됨 ConnectionManager)
ServerMessage	SQL Server 경고 또는 정보 메시지를 반환할 때 발생합니다. SqlClient.SqlInfoMessageEventHandler를 사용합니다. (다음에서 상속됨 ConnectionManager)
StateChange	연결 상태가 변경되면 발생합니다. System.Data.StateChangeEventHandler를 사용합니다. (다음에서 상속됨 ConnectionManager)
StatementExecuted	(다음에서 상속됨 ConnectionManager)

명시적 인터페이스 구현

Name	Description
ISfcConnection.Connect()
ISfcConnection.Copy()
ISfcConnection.Disconnect()
ISfcConnection.ServerVersion
ISfcConnection.ToEnumeratorObject()