다음을 통해 공유


ServerConnection 클래스

ServerConnection 개체는 서버에 대한 연결을 나타냅니다.

상속 계층

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

네임스페이스:  Microsoft.SqlServer.Management.Common
어셈블리:  Microsoft.SqlServer.ConnectionInfo(Microsoft.SqlServer.ConnectionInfo.dll)

구문

‘선언
Public NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
‘사용 방법
Dim instance As ServerConnection
public sealed class ServerConnection : ConnectionManager, 
    ISfcConnection
public ref class ServerConnection sealed : public ConnectionManager, 
    ISfcConnection
[<SealedAttribute>]
type ServerConnection =  
    class 
        inherit ConnectionManager 
        interface ISfcConnection 
    end
public final class ServerConnection extends ConnectionManager implements ISfcConnection

ServerConnection 유형에서 다음 멤버를 표시합니다.

생성자

  이름 설명
공용 메서드 ServerConnection() ServerConnection 클래스의 새 인스턴스를 초기화합니다.
공용 메서드 ServerConnection(SqlConnection) 지정한 연결 매개 변수를 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다.
공용 메서드 ServerConnection(String) 지정한 서버 인스턴스를 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다.
공용 메서드 ServerConnection(SqlConnectionInfo) 지정한 연결 정보를 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다.
공용 메서드 ServerConnection(String, String, SecureString) 지정한 서버 인스턴스와 로그온 자격 증명을 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다.
공용 메서드 ServerConnection(String, String, String) 지정한 서버 인스턴스와 로그온 자격 증명을 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다.

위쪽

속성

  이름 설명
공용 속성 ApplicationName 서버에 연결한 응용 프로그램의 이름을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 AutoDisconnectMode SQL Server 인스턴스에 대한 참조된 연결의 자동 연결 끊기 모드를 가져오거나 설정합니다. (ConnectionManager에서 상속됨)
공용 속성 BatchSeparator 참조된 연결에서 일괄 처리를 구분하는 데 사용되는 문자열 값을 가져오거나 설정합니다.
공용 속성 CapturedSql 연결이 캡처 모드로 실행되고 있을 때 캡처되는 Transact-SQL 문을 가져옵니다. (ConnectionManager에서 상속됨)
공용 속성 ConnectAsUser 가장을 사용하여 연결되는지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ConnectAsUserName 가장을 사용하여 연결할 때 사용자의 이름을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ConnectAsUserPassword 가장을 사용하여 연결할 때 사용자의 암호를 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ConnectionString 지정한 데이터 원본에 연결하는 데 사용되는 연결 문자열을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ConnectionType 서버에 사용할 연결의 유형을 가져옵니다.
공용 속성 ConnectTimeout 연결 제한 시간(초)을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 DatabaseEngineType 데이터베이스 엔진 유형을 가져옵니다. (ConnectionManager에서 상속됨)
공용 속성 DatabaseName 연결에 필요한 데이터베이스를 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 EncryptConnection 연결이 암호화되는지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 FixedServerRoles 참조된 연결과 관련된 고정 서버 역할을 가져옵니다.
공용 속성 InUse 연결이 사용 중인지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (ConnectionManager에서 상속됨)
공용 속성 IsForceDisconnected 연결이 강제로 끊어졌는지 여부를 지정하는 Boolean 값을 가져옵니다. (ConnectionManager에서 상속됨)
공용 속성 IsOpen 연결이 현재 열려 있는지 여부를 지정하는 Boolean 속성 값을 가져옵니다. (ConnectionManager에서 상속됨)
공용 속성 LockTimeout 현재 트랜잭션이 잠겨 있을 때 연결 시간이 초과되는 데 걸리는 시간(초)을 가져오거나 설정합니다. (ConnectionManager에서 상속됨)
공용 속성 Login 서버 인스턴스에 연결하는 데 필요한 로그온을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 LoginSecure 서버에 연결할 때 Windows 인증을 사용하는지, 아니면 SQL Server 인증을 사용하는지 지정하는 Boolean 속성을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 MaxPoolSize 서버에 연결할 때 지정한 연결에 허용되는 연결 풀 내의 최대 연결 수를 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 MinPoolSize 서버에 연결할 때 지정한 연결에 허용되는 연결 풀 내의 최소 연결 수를 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 MultipleActiveResultSets 활성 결과 집합이 두 개 이상 허용되는지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 NetworkProtocol 서버에 연결하는 데 사용되는 네트워크 프로토콜을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 NonPooledConnection 연결이 풀링될 수 있는지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 PacketSize 네트워크를 통해 클라이언트와 서버 간에 전송되는 데이터 패킷(바이트)을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성정적 멤버 ParameterizationMode 서버 연결의 매개 변수화 모드를 가져오거나 설정합니다.
공용 속성 Password SQL Server 인증 사용 시 로그온과 함께 서버 연결에 사용되는 암호를 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 PooledConnectionLifetime 풀링된 연결의 수명을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ProcessID 서버에 대한 참조된 연결과 관련된 프로세스를 고유하게 식별하는 ID 값을 가져옵니다.
공용 속성 SecureConnectionString 암호화된 버전의 연결 문자열을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 SecurePassword SQL Server 인증 사용 시 로그온과 함께 서버 연결에 사용되는 보안 암호를 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ServerInstance 서버의 이름을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)
공용 속성 ServerVersion SQL Server의 연결된 인스턴스 버전을 가져옵니다. (ConnectionManager에서 상속됨)
공용 속성 SqlConnectionObject 연결 개체를 가져옵니다. (ConnectionManager에서 상속됨)
공용 속성 SqlExecutionModes 서버에 대한 참조된 연결과 관련된 실행 모드를 가져오거나 설정합니다.
공용 속성 StatementTimeout 문 실행 후 제한 시간 오류로 실패했다고 간주되는 시간(초)을 가져오거나 설정합니다.
공용 속성 TransactionDepth 참조된 연결에 대한 현재 트랜잭션 깊이를 가져옵니다.
공용 속성 TrueLogin 참조된 연결에 사용되는 현재 로그온 레코드 이름을 가져옵니다.
공용 속성 TrueName 서버의 이름을 가져옵니다.
공용 속성정적 멤버 UseMode 지정한 모드를 사용하여 서버 연결을 가져오거나 설정합니다.
공용 속성 UserProfile 참조된 연결과 관련된 사용자 프로필을 가져옵니다.
공용 속성 WorkstationId 워크스테이션을 고유하게 식별하는 ID 값을 가져오거나 설정합니다. (ConnectionSettings에서 상속됨)

위쪽

메서드

  이름 설명
공용 메서드 BeginTransaction 참조된 연결에서 트랜잭션을 시작합니다.
공용 메서드 Cancel 연결을 취소합니다.
공용 메서드 ChangePassword(SecureString) 표준 인증에 사용되는 로그인 암호를 변경합니다.
공용 메서드 ChangePassword(String) 표준 인증에 사용되는 로그온 암호를 변경합니다.
공용 메서드 CommitTransaction 참조된 연결에서 현재 트랜잭션을 커밋합니다.
공용 메서드 Connect SQL Server 인스턴스에 연결합니다. (ConnectionManager에서 상속됨)
공용 메서드 Copy ServerConnection 개체의 복사본을 반환합니다.
공용 메서드 Disconnect SQL Server 인스턴스 연결을 끊습니다. (ConnectionManager에서 상속됨)
공용 메서드 Equals (Object에서 상속됨)
공용 메서드 ExecuteNonQuery(StringCollection) 결과 집합을 반환하지 않는 문의 일괄 처리를 실행합니다.
공용 메서드 ExecuteNonQuery(String) 결과 집합을 반환하지 않는 문을 실행합니다.
공용 메서드 ExecuteNonQuery(StringCollection, ExecutionTypes) 결과 집합을 반환하지 않는 지정한 실행 옵션으로 문의 일괄 처리를 실행합니다.
공용 메서드 ExecuteNonQuery(String, ExecutionTypes) 결과 집합을 반환하지 않는 지정한 실행 옵션으로 문을 실행합니다.
공용 메서드 ExecuteReader(String) 하나 또는 여러 결과 집합을 반환하는 Transact-SQL 문을 실행합니다.
공용 메서드 ExecuteReader(String, SqlCommand%) 하나 또는 여러 결과 집합을 포함하는 SqlDataReader 개체 값을 사용하여 판독기를 실행합니다.
공용 메서드 ExecuteScalar(StringCollection) Transact-SQL 문의 일괄 처리를 실행하고 첫 번째 행의 첫 번째 열을 개체 값으로 반환합니다.
공용 메서드 ExecuteScalar(String) Transact-SQL 문을 실행하고 첫 번째 행의 첫 번째 열을 개체 값으로 반환합니다.
공용 메서드 ExecuteWithResults(StringCollection) 여러 결과 집합을 반환하는 Transact-SQL 문의 일괄 처리를 실행합니다.
공용 메서드 ExecuteWithResults(String) 결과 집합을 반환하는 Transact-SQL 문을 실행합니다.
공용 메서드 ForceDisconnected 강제로 SQL Server 인스턴스 연결을 끊습니다. (ConnectionManager에서 상속됨)
공용 메서드 GetHashCode (Object에서 상속됨)
공용 메서드 GetType (Object에서 상속됨)
공용 메서드 IsInFixedServerRole 참조된 연결과 관련된 로그온이 지정한 고정 서버 역할의 멤버인지 여부를 테스트합니다.
공용 메서드정적 멤버 NormalizeQuery(String) 쿼리 텍스트를 나타내는 문자열 입력을 사용합니다.
공용 메서드정적 멤버 NormalizeQuery(String, Boolean) 서버 연결을 제어하는 쿼리를 정규화합니다.
공용 메서드 RollBackTransaction 현재 트랜잭션을 롤백합니다.
공용 메서드 ToString 참조된 개체 이름을 문자열로 반환합니다. (ConnectionSettings에서 상속됨)

위쪽

이벤트

  이름 설명
공용 이벤트 InfoMessage SQL Server 인스턴스가 정보 메시지를 생성할 때 발생하는 이벤트입니다.  (ConnectionManager에서 상속됨)
공용 이벤트 RemoteLoginFailed 이 이벤트는 원격 로그인으로 SQL Server 인스턴스에 연결하지 못할 때 발생합니다. (ConnectionManager에서 상속됨)
공용 이벤트 ServerMessage SQL Server가 현재 연결에서 경고 또는 정보 메시지를 반환할 때 발생하는 이벤트입니다. (ConnectionManager에서 상속됨)
공용 이벤트 StateChange SQL Server 인스턴스가 상태를 변경할 때 발생하는 이벤트입니다.  (ConnectionManager에서 상속됨)
공용 이벤트 StatementExecuted SQL Server 인스턴스가 현재 연결에서 문을 실행할 때 발생하는 이벤트입니다.  (ConnectionManager에서 상속됨)

위쪽

명시적 인터페이스 구현

  이름 설명
명시적 인터페이스 구현전용 메서드 ISfcConnection.Connect SFC 연결을 사용하여 연결할 서버를 나타내는 값을 반환합니다.
명시적 인터페이스 구현전용 메서드 ISfcConnection.Copy SFC 연결을 사용하여 서버 연결을 복사합니다.
명시적 인터페이스 구현전용 메서드 ISfcConnection.Disconnect 연결을 끊습니다.
명시적 인터페이스 구현전용 속성 ISfcConnection.ServerVersion 서버의 버전을 가져옵니다.
명시적 인터페이스 구현전용 메서드 ISfcConnection.ToEnumeratorObject 서버 연결에 대한 열거자 개체를 렌더링합니다.

위쪽

주의

ServerConnection클래스에 의해 제공 되는 Server클래스와 같은복제클래스는 ReplicationServer클래스

일반적으로, 당신은의인스턴스를 선언 하지 않아도 ServerConnection개체는 서버 개체와 함께 자동으로 생성 하기 때문에. 선언 된 ServerConnection개체 변수다시 사용에 대 한 연결 설정을 저장 하려는 경우. ServerConnection 개체에 서버 개체 요소의 ConnectionContext속성. ServerConnection개체는 서버 개체의인스턴스사이 연결에 관련 된 속성을 포함 SQL Server. 보거나 처리 거래,인증모드, 실행 모드 프로세스 ID 같은 연결의 특정 측면을 수정 하 고 실행도 사용할 수 있습니다 Transact-SQL직접 명령.

사용 하 여는 ServerConnection개체, 다음을 수행할 수 있습니다:

  • 실행 Transact-SQL의인스턴스를 연결을 통해 직접 문 을 SQL Server.

  • 인증메서드같은 연결 설정을 변경 합니다.

  • 시작, 커밋 및 트랜잭션을 롤백하십시오.

  • 캡처는 Transact-SQLSMO 응용 프로그램에서 생성 하는 문.

이메서드의 또 다른 예는 Database개체 참조 하십시오 [M:Microsoft.SqlServer.Management.Smo.Database.ExecuteNonQuery(System.String].

VB

'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.

PowerShell

$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.LoginSecure = $FALSE
$conn.Login = vlogin
$conn.Password = vpassword
#Connect to the local, default instance of SQL Server
$srv = new-object Microsoft.SqlServer.Management.Smo.Server($conn)
Write-Host $srv.Information.Version

스레드 보안

이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

Microsoft.SqlServer.Management.Common 네임스페이스

관련 자료

SQL Server 인스턴스에 연결

SQL Server 인스턴스에 연결