Database.ExecuteNonQuery Method (StringCollection)

Executes a batch in the context of the database where there are no results returned.

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

Syntax

'Declaration
Public Sub ExecuteNonQuery ( _
    sqlCommands As StringCollection _
)
'Usage
Dim instance As Database 
Dim sqlCommands As StringCollection

instance.ExecuteNonQuery(sqlCommands)

public void ExecuteNonQuery(
    StringCollection sqlCommands
)

public:
void ExecuteNonQuery(
    StringCollection^ sqlCommands
)

member ExecuteNonQuery : 
        sqlCommands:StringCollection -> unit

public function ExecuteNonQuery(
    sqlCommands : StringCollection
)

Parameters

• sqlCommands
  Type: System.Collections.Specialized.StringCollection
  A StringCollection system object value that contains more than one Transact-SQL command.

Remarks

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

Examples

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server

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

'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

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")
$db.ExecuteNonQuery("CHECKPOINT")
$ds = $db.ExecuteWithResults("SELECT * FROM Person.Address")
Foreach ($t in $ds.Tables)
{
   Foreach ($r in $t.Rows)
   {
      Foreach ($c in $t.Columns)
      {
          Write-Host $c.ColumnName "=" $r.Item($c)
      }
   }
}

See Also

Reference

Database Class

ExecuteNonQuery Overload

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Working with Database Objects

Creating, Altering, and Removing Databases

CREATE DATABASE (Transact-SQL)