ServerConnection-Klasse

Vererbungshierarchie

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

Syntax

'Declaration
Public NotInheritable Class ServerConnection _
    Inherits ConnectionManager _
    Implements ISfcConnection
'Usage
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

Konstruktoren

	Name	Beschreibung
	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.

Zum Anfang

Eigenschaften

	Name	Beschreibung
	ApplicationName	Gets or sets the name of the application that has established the connection with the server. (Geerbt von ConnectionSettings.)
	AutoDisconnectMode	Gets or sets the automatic disconnection mode of the referenced connection to the instance of SQL Server. (Geerbt von 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. (Geerbt von ConnectionManager.)
	ConnectAsUser	Gets or sets the Boolean property value that specifies whether the connection is established using impersonation. (Geerbt von ConnectionSettings.)
	ConnectAsUserName	Gets or sets the name of the user when connecting using impersonation. (Geerbt von ConnectionSettings.)
	ConnectAsUserPassword	Gets or sets the password for the user when connecting using impersonation. (Geerbt von ConnectionSettings.)
	ConnectionString	Gets or sets the connection string used to establish a connection with a specified data source. (Geerbt von ConnectionSettings.)
	ConnectionType	Gets the type of connection to use in the server.
	ConnectTimeout	Gets or sets the connection time-out period in seconds. (Geerbt von ConnectionSettings.)
	DatabaseEngineType	Gets the database engine type. (Geerbt von ConnectionManager.)
	DatabaseName	Gets or sets the database required by the connection. (Geerbt von ConnectionSettings.)
	EncryptConnection	Gets or sets the Boolean property value that specifies whether the connection is encrypted. (Geerbt von 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. (Geerbt von ConnectionManager.)
	IsForceDisconnected	Gets a Boolean value that specifies whether the connection was forcibly disconnected. (Geerbt von ConnectionManager.)
	IsOpen	Gets the Boolean property value that specifies whether the connection is currently open. (Geerbt von ConnectionManager.)
	LockTimeout	Gets or sets the time in seconds required for the connection to time out when the current transaction is locked. (Geerbt von ConnectionManager.)
	Login	Gets or sets the logon required to establish a connection with the instance of the server. (Geerbt von 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. (Geerbt von 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. (Geerbt von 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. (Geerbt von ConnectionSettings.)
	MultipleActiveResultSets	Gets or sets the Boolean property value that specifies whether more than one active result set is permitted. (Geerbt von ConnectionSettings.)
	NetworkProtocol	Gets or sets the network protocol used to establish the connection to the server. (Geerbt von ConnectionSettings.)
	NonPooledConnection	Gets or sets the Boolean property value that specifies whether the connection may be pooled or nonpooled. (Geerbt von ConnectionSettings.)
	PacketSize	Gets or sets the packets of data sent between the client and the server over the network in bytes. (Geerbt von 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. (Geerbt von ConnectionSettings.)
	PooledConnectionLifetime	Gets or sets the lifetime of the pooled connection. (Geerbt von ConnectionSettings.)
	ProcessID	Gets the ID value that uniquely identifies the process associated with the referenced connection to the server.
	ResetConnectionString	Gets or sets a Boolean value that specifies whether a node in the connection string has been changed. (Geerbt von ConnectionSettings.)
	SecureConnectionString	Gets or sets an encrypted version of the connection string. (Geerbt von 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. (Geerbt von ConnectionSettings.)
	ServerInstance	Gets or sets the name of the server. (Geerbt von ConnectionSettings.)
	ServerVersion	Gets the version of the connected instance of SQL Server. (Geerbt von ConnectionManager.)
	SqlConnectionObject	Gets the connection object. (Geerbt von 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. (Geerbt von ConnectionSettings.)

Zum Anfang

Methoden

	Name	Beschreibung
	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.
	CheckServerVersion	Checks the version of the target instance of SQL Server. (Geerbt von ConnectionManager.)
	CommitTransaction	Commits the current transaction on the referenced connection.
	Connect	Connects to the instance of SQL Server. (Geerbt von ConnectionManager.)
	Copy	Returns a copy of the ServerConnection object.
	Disconnect	Disconnects from the instance of SQL Server. (Geerbt von ConnectionManager.)
	Equals	(Geerbt von 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.
	ExecuteTSql	Executes a Transact-SQL command. (Geerbt von ConnectionManager.)
	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.
	Finalize	(Geerbt von Object.)
	ForceDisconnected	Forces a disconnect from the instance of SQL Server. (Geerbt von ConnectionManager.)
	GetHashCode	(Geerbt von Object.)
	GetType	(Geerbt von Object.)
	IsInFixedServerRole	Tests whether the logon associated with the referenced connection is a member of the specified fixed server role.
	MemberwiseClone	(Geerbt von Object.)
	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.
	ThrowIfPropertyNotSet(String, String)	Throws an exception if the specified connection property is null or empty. (Geerbt von ConnectionSettings.)
	ThrowIfPropertyNotSet(String, String, Boolean)	Throws an exception if the specified connection property is null or, optionally, empty. (Geerbt von ConnectionSettings.)
	ToString	Returns the referenced object name as a string. (Geerbt von ConnectionSettings.)

Zum Anfang

Ereignisse

	Name	Beschreibung
	InfoMessage	The event that occurs when the instance of SQL Server generates an informational message.  (Geerbt von ConnectionManager.)
	RemoteLoginFailed	This event occurs when a remote login fails to connect to the instance of SQL Server. (Geerbt von ConnectionManager.)
	ServerMessage	The event that occurs when SQL Server returns a warning or informational message on the current connection. (Geerbt von ConnectionManager.)
	StateChange	The event that occurs when the instance of SQL Server changes state.  (Geerbt von ConnectionManager.)
	StatementExecuted	The event that occurs when the instance of SQL Server executes a statement on the current connection.  (Geerbt von ConnectionManager.)

Zum Anfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	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.

Zum Anfang

Hinweise

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.

Beispiele

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Andere Ressourcen