다음을 통해 공유


ServerConnection 클래스

The ServerConnection object represents a connection to a server.

상속 계층

System.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() Initializes a new instance of the ServerConnection class.
공용 메서드 ServerConnection(SqlConnection) Initializes a new instance of the ServerConnection class with the specified connection parameters.
공용 메서드 ServerConnection(String) Initializes a new instance of the ServerConnection class with the specified server instance.
공용 메서드 ServerConnection(SqlConnectionInfo) Initializes a new instance of the ServerConnection class with the specified connection information.
공용 메서드 ServerConnection(String, String, SecureString) Initializes a new instance of the ServerConnection class with the specified server instance and logon credentials.
공용 메서드 ServerConnection(String, String, String) Initializes a new instance of the ServerConnection class with the specified server instance and logon credentials.

맨 위로 이동

속성

  이름 설명
공용 속성 ApplicationName Gets or sets the name of the application that has established the connection with the server. (ConnectionSettings에서 상속됨)
공용 속성 AutoDisconnectMode Gets or sets the automatic disconnection mode of the referenced connection to the instance of SQL Server. (ConnectionManager에서 상속됨)
공용 속성 BatchSeparator Gets or sets the string value used to separate batches in the referenced connection.
공용 속성 CapturedSql Gets the Transact-SQL statements that are captured when the connection is running in capture mode. (ConnectionManager에서 상속됨)
공용 속성 ConnectAsUser Gets or sets the Boolean property value that specifies whether the connection is established using impersonation. (ConnectionSettings에서 상속됨)
공용 속성 ConnectAsUserName Gets or sets the name of the user when connecting using impersonation. (ConnectionSettings에서 상속됨)
공용 속성 ConnectAsUserPassword Gets or sets the password for the user when connecting using impersonation. (ConnectionSettings에서 상속됨)
공용 속성 ConnectionString Gets or sets the connection string used to establish a connection with a specified data source. (ConnectionSettings에서 상속됨)
공용 속성 ConnectionType Gets the type of connection to use in the server.
공용 속성 ConnectTimeout Gets or sets the connection time-out period in seconds. (ConnectionSettings에서 상속됨)
공용 속성 DatabaseEngineType Gets the database engine type. (ConnectionManager에서 상속됨)
공용 속성 DatabaseName Gets or sets the database required by the connection. (ConnectionSettings에서 상속됨)
공용 속성 EncryptConnection Gets or sets the Boolean property value that specifies whether the connection is encrypted. (ConnectionSettings에서 상속됨)
공용 속성 FixedServerRoles Gets the fixed server role associated with the referenced connection.
공용 속성 InUse Gets or sets the Boolean property value that specifies whether the connection is being used. (ConnectionManager에서 상속됨)
공용 속성 IsForceDisconnected Gets a Boolean value that specifies whether the connection was forcibly disconnected. (ConnectionManager에서 상속됨)
공용 속성 IsOpen Gets the Boolean property value that specifies whether the connection is currently open. (ConnectionManager에서 상속됨)
공용 속성 LockTimeout Gets or sets the time in seconds required for the connection to time out when the current transaction is locked. (ConnectionManager에서 상속됨)
공용 속성 Login Gets or sets the logon required to establish a connection with the instance of the server. (ConnectionSettings에서 상속됨)
공용 속성 LoginSecure Gets or sets the Boolean property that specifies whether the connection is established to the server by using Windows Authentication or SQL Server Authentication. (ConnectionSettings에서 상속됨)
공용 속성 MaxPoolSize Gets or sets the maximum number of connections in a connection pool that the specified connection accepts when establishing a connection with a server. (ConnectionSettings에서 상속됨)
공용 속성 MinPoolSize Gets or sets the minimum number of connections in a connection pool that the specified connection accepts when establishing a connection with a server. (ConnectionSettings에서 상속됨)
공용 속성 MultipleActiveResultSets Gets or sets the Boolean property value that specifies whether more than one active result set is permitted. (ConnectionSettings에서 상속됨)
공용 속성 NetworkProtocol Gets or sets the network protocol used to establish the connection to the server. (ConnectionSettings에서 상속됨)
공용 속성 NonPooledConnection Gets or sets the Boolean property value that specifies whether the connection may be pooled or nonpooled. (ConnectionSettings에서 상속됨)
공용 속성 PacketSize Gets or sets the packets of data sent between the client and the server over the network in bytes. (ConnectionSettings에서 상속됨)
공용 속성정적 멤버 ParameterizationMode Gets or sets the parameterization mode for the server connection.
공용 속성 Password Gets or sets the password used with the logon to establish a connection with the server when SQL Server Authentication is used. (ConnectionSettings에서 상속됨)
공용 속성 PooledConnectionLifetime Gets or sets the lifetime of the pooled connection. (ConnectionSettings에서 상속됨)
공용 속성 ProcessID Gets the ID value that uniquely identifies the process associated with the referenced connection to the server.
공용 속성 SecureConnectionString Gets or sets an encrypted version of the connection string. (ConnectionSettings에서 상속됨)
공용 속성 SecurePassword Gets or sets the secure password used with the logon to establish a connection with the server when SQL Server Authentication is used. (ConnectionSettings에서 상속됨)
공용 속성 ServerInstance Gets or sets the name of the server. (ConnectionSettings에서 상속됨)
공용 속성 ServerVersion Gets the version of the connected instance of SQL Server. (ConnectionManager에서 상속됨)
공용 속성 SqlConnectionObject Gets the connection object. (ConnectionManager에서 상속됨)
공용 속성 SqlExecutionModes Gets or sets the execution mode associated with the referenced connection to the server.
공용 속성 StatementTimeout Gets or sets the number of seconds a statement is given to run before failing with a time-out error.
공용 속성 TransactionDepth Gets the current transaction depth for the referenced connection.
공용 속성 TrueLogin Gets the current logon record name used by the referenced connection.
공용 속성 TrueName Gets the name of the server.
공용 속성정적 멤버 UseMode Gets or sets the server connection using a specified mode.
공용 속성 UserProfile Gets the user profile associated with the referenced connection.
공용 속성 WorkstationId Gets or sets the ID value that uniquely identifies the workstation. (ConnectionSettings에서 상속됨)

맨 위로 이동

메서드

  이름 설명
공용 메서드 BeginTransaction Starts a transaction on the referenced connection.
공용 메서드 Cancel Cancels the connection.
공용 메서드 ChangePassword(SecureString) Changes the login password that is used with standard authentication.
공용 메서드 ChangePassword(String) Changes the logon password that is used with standard authentication.
공용 메서드 CommitTransaction Commits the current transaction on the referenced connection.
공용 메서드 Connect Connects to the instance of SQL Server. (ConnectionManager에서 상속됨)
공용 메서드 Copy Returns a copy of the ServerConnection object.
공용 메서드 Disconnect Disconnects from the instance of SQL Server. (ConnectionManager에서 상속됨)
공용 메서드 Equals (Object에서 상속됨)
공용 메서드 ExecuteNonQuery(StringCollection) Executes a batch of statements that do not return a result set.
공용 메서드 ExecuteNonQuery(String) Executes a statement that does not return a result set.
공용 메서드 ExecuteNonQuery(StringCollection, ExecutionTypes) Executes a batch of statements with the specified execution options that does not return a result set.
공용 메서드 ExecuteNonQuery(String, ExecutionTypes) Executes a statement with the specified execution options that does not return a result set.
공용 메서드 ExecuteReader(String) Executes Transact-SQL statements that return one or multiple result sets.
공용 메서드 ExecuteReader(String, SqlCommand%) Executes a reader using a SqlDataReader object value that contains one or more result sets.
공용 메서드 ExecuteScalar(StringCollection) Executes a batch of Transact-SQL statements and returns the first column of the first row as an object value.
공용 메서드 ExecuteScalar(String) Executes a Transact-SQL statement and returns the first column of the first row as an object value.
공용 메서드 ExecuteWithResults(StringCollection) Executes a batch of Transact-SQL statements that return multiple result sets.
공용 메서드 ExecuteWithResults(String) Executes a Transact-SQL statement that returns a result set.
공용 메서드 ForceDisconnected Forces a disconnect from the instance of SQL Server. (ConnectionManager에서 상속됨)
공용 메서드 GetHashCode (Object에서 상속됨)
공용 메서드 GetType (Object에서 상속됨)
공용 메서드 IsInFixedServerRole Tests whether the logon associated with the referenced connection is a member of the specified fixed server role.
공용 메서드정적 멤버 NormalizeQuery(String) Uses a string input that represents the query text.
공용 메서드정적 멤버 NormalizeQuery(String, Boolean) Normalizes the query that controls the server connection.
공용 메서드 RollBackTransaction Rolls back the current transaction.
공용 메서드 ToString Returns the referenced object name as a string. (ConnectionSettings에서 상속됨)

맨 위로 이동

이벤트

  이름 설명
공용 이벤트 InfoMessage The event that occurs when the instance of SQL Server generates an informational message.  (ConnectionManager에서 상속됨)
공용 이벤트 RemoteLoginFailed This event occurs when a remote login fails to connect to the instance of SQL Server. (ConnectionManager에서 상속됨)
공용 이벤트 ServerMessage The event that occurs when SQL Server returns a warning or informational message on the current connection. (ConnectionManager에서 상속됨)
공용 이벤트 StateChange The event that occurs when the instance of SQL Server changes state.  (ConnectionManager에서 상속됨)
공용 이벤트 StatementExecuted The event that occurs when the instance of SQL Server executes a statement on the current connection.  (ConnectionManager에서 상속됨)

맨 위로 이동

명시적 인터페이스 구현

  이름 설명
명시적 인터페이스 구현전용 메서드 ISfcConnection.Connect Returns a value that indicates the server to connect using an SFC connection.
명시적 인터페이스 구현전용 메서드 ISfcConnection.Copy Uses the SFC connection to copy the server connection.
명시적 인터페이스 구현전용 메서드 ISfcConnection.Disconnect Disconnects the connection.
명시적 인터페이스 구현전용 속성 ISfcConnection.ServerVersion Gets the version of the server.
명시적 인터페이스 구현전용 메서드 ISfcConnection.ToEnumeratorObject Renders an enumerator object for the server connection.

맨 위로 이동

주의

The ServerConnection class is served by the Server class and replication classes such as the ReplicationServer class.

Typically, you don't have to declare an instance of the ServerConnection object because it is created automatically with the Server object. Declare a ServerConnection object variable if you want to store the connection settings for re-use. The ConnectionContext property of the Server object points to a ServerConnection object. The ServerConnection object contains properties that relate to the connection between the Server object and the instance of SQL Server. You can use it to view or modify certain aspects of the connection, such as the process ID, processing transactions, the authentication mode, execution mode, and even to run Transact-SQL commands directly.

By using the ServerConnection object, you can do the following:

  • Run Transact-SQL statements directly over the connection to the instance of SQL Server.

  • Change the connection settings, such as the authentication method.

  • Begin, commit and roll back transactions.

  • Capture the Transact-SQL statements generated by the SMO application.

For another example of this method with the Database object, see [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 인스턴스에 연결