ServerConnection.SqlExecutionModes Property

Gets or sets the execution mode associated with the referenced connection to the server.

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

Syntax

'Declaration
Public Property SqlExecutionModes As SqlExecutionModes
public SqlExecutionModes SqlExecutionModes { get; set; }
public:
property SqlExecutionModes SqlExecutionModes {
    SqlExecutionModes get ();
    void set (SqlExecutionModes value);
}
/** @property */
public SqlExecutionModes get_SqlExecutionModes ()

/** @property */
public void set_SqlExecutionModes (SqlExecutionModes value)
public function get SqlExecutionModes () : SqlExecutionModes

public function set SqlExecutionModes (value : SqlExecutionModes)

Property Value

A SqlExecutionModes object value that specifies the execution mode associated with the referenced connection.

Remarks

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Set the execution mode to CaptureSql for the connection.
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.CaptureSql
'Make a modification to the server that is to be captured.
srv.UserOptions.AnsiNulls = True
srv.Alter()
'Iterate through the strings in the capture buffer and display the captured statements.
Dim s As String
For Each s In srv.ConnectionContext.CapturedSql.Text
    Console.WriteLine(s)
Next
'Execute the captured statements.
srv.ConnectionContext.ExecuteNonQuery(srv.ConnectionContext.CapturedSql.Text)
'Revert to immediate execution mode. 
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.ExecuteSql

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

ServerConnection Class
ServerConnection Members
Microsoft.SqlServer.Management.Common Namespace

Other Resources

How to: Enable Capture Mode in Visual Basic .NET
Using Capture Mode