• Article

ConnectionInfoBase.ConnectionParmsChanged Method

When overridden in a derived class, enables you to specify custom actions when a connection parameter changes.

Namespace:  Microsoft.SqlServer.Management.Common
Assembly:  Microsoft.SqlServer.ConnectionInfo (in Microsoft.SqlServer.ConnectionInfo.dll)

Syntax

'Declaration
Protected MustOverride Sub ConnectionParmsChanged
'Usage

Me.ConnectionParmsChanged()

protected abstract void ConnectionParmsChanged()

protected:
virtual void ConnectionParmsChanged() abstract

abstract ConnectionParmsChanged : unit -> unit 

protected abstract function ConnectionParmsChanged()

Remarks

SQL Server calls this method when any of the following parameters change on an open connection:

  • ServerName

  • SqlConnection

  • UserName

  • Password and SecurePassword

  • UseIntegratedSecurity

  • DatabaseName

  • ConnectionTimeout

In Integration Services, changes to the following parameters also initiate a call to this method:

  • ApplicationName

  • WorkstationID

In SQL Server Compact 3.5, changes to the following parameters also initiate a call to this method:

  • MaxDatabaseSize

  • DefaultLockEscalation

Standard SQL Server connection classes, such as SqlConnectionInfo, provide a default implementation of this method, which then rebuilds the connection string. If you are creating your own connection class based on ConnectionInfoBase, you must override this method and implement your own logic for handling connection parameter changes.