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 유형에서 다음 멤버를 표시합니다.
생성자
| 이름 | 설명 | |
|---|---|---|
.gif "공용 메서드") |
ServerConnection() | ServerConnection 클래스의 새 인스턴스를 초기화합니다. |
|
ServerConnection(SqlConnection) | 지정한 연결 매개 변수를 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다. |
|
ServerConnection(String) | 지정한 서버 인스턴스를 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다. |
|
ServerConnection(SqlConnectionInfo) | 지정한 연결 정보를 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다. |
|
ServerConnection(String, String, SecureString) | 지정한 서버 인스턴스와 로그온 자격 증명을 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다. |
|
ServerConnection(String, String, String) | 지정한 서버 인스턴스와 로그온 자격 증명을 포함하는 ServerConnection 클래스의 새 인스턴스를 초기화합니다. |
위쪽
속성
| 이름 | 설명 | |
|---|---|---|
.gif "공용 속성") |
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에서 상속됨) |
.gif "정적 멤버") |
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에서 상속됨) |
위쪽
이벤트
| 이름 | 설명 | |
|---|---|---|
.gif "공용 이벤트") |
InfoMessage | SQL Server 인스턴스가 정보 메시지를 생성할 때 발생하는 이벤트입니다. (ConnectionManager에서 상속됨) |
|
RemoteLoginFailed | 이 이벤트는 원격 로그인으로 SQL Server 인스턴스에 연결하지 못할 때 발생합니다. (ConnectionManager에서 상속됨) |
|
ServerMessage | SQL Server가 현재 연결에서 경고 또는 정보 메시지를 반환할 때 발생하는 이벤트입니다. (ConnectionManager에서 상속됨) |
|
StateChange | SQL Server 인스턴스가 상태를 변경할 때 발생하는 이벤트입니다. (ConnectionManager에서 상속됨) |
|
StatementExecuted | SQL Server 인스턴스가 현재 연결에서 문을 실행할 때 발생하는 이벤트입니다. (ConnectionManager에서 상속됨) |
위쪽
명시적 인터페이스 구현
| 이름 | 설명 | |
|---|---|---|
.gif "명시적 인터페이스 구현") .gif "전용 메서드") |
ISfcConnection.Connect | SFC 연결을 사용하여 연결할 서버를 나타내는 값을 반환합니다. |
|
ISfcConnection.Copy | SFC 연결을 사용하여 서버 연결을 복사합니다. |
|
ISfcConnection.Disconnect | 연결을 끊습니다. |
.gif "전용 속성") |
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 네임스페이스