Jaa


Database.ExecuteNonQuery Method (StringCollection, ExecutionTypes)

Runs a collection of batches in the context of the database where there are no results returned for the specified execution type only.

Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Sub ExecuteNonQuery ( _
    sqlCommands As StringCollection, _
    executionType As ExecutionTypes _
)
public void ExecuteNonQuery (
    StringCollection sqlCommands,
    ExecutionTypes executionType
)
public:
void ExecuteNonQuery (
    StringCollection^ sqlCommands, 
    ExecutionTypes executionType
)
public void ExecuteNonQuery (
    StringCollection sqlCommands, 
    ExecutionTypes executionType
)
public function ExecuteNonQuery (
    sqlCommands : StringCollection, 
    executionType : ExecutionTypes
)

Parameters

  • sqlCommands
    A StringCollection System object value that contains more than one Transact-SQL command.
  • executionType
    An ExecutionTypes object value that specifies the execution type.

Remarks

Updated text:17 July 2006

The StringCollection value of the sqlCommands parameter makes it possible to send a Transact-SQL script with multiple commands.

The executionType parameter is used to filter the types of commands that are run. For example, you can specify that the execution continue after encountering an error with the ContinueOnError option.

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

'Reference the AdventureWorks database.
Dim db As Database
db = srv.Databases("AdventureWorks")

'Run a Transact-SQL command on the database.
db.ExecuteNonQuery("CHECKPOINT")

'Run a Transact-SQL command with results and display.
Dim ds As DataSet
ds = db.ExecuteWithResults( _
"SELECT * FROM Person.Address")
Dim t As DataTable
Dim r As DataRow
Dim c As DataColumn
For Each t In ds.Tables
   For Each r In t.Rows
      For Each c In r.Table.Columns
          Console.WriteLine( _
          c.ColumnName + " = " + r(c).ToString)
      Next
   Next
Next

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

Database Class
Database Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

How to: Create, Alter, and Remove a Database in Visual Basic .NET
Creating, Altering, and Removing Databases
CREATE DATABASE (Transact-SQL)

Change History

Release

History

17 July 2006

Changed content:
  • Added text to the Remarks section.

  • Added code to the Example section.