Database.ExecuteWithResults Method (String)

Executes a collection of batches in the context of the database where there are results returned.

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

Syntax

'Declaration
Public Function ExecuteWithResults ( _
    sqlCommand As String _
) As DataSet
'Usage
Dim instance As Database 
Dim sqlCommand As String 
Dim returnValue As DataSet 

returnValue = instance.ExecuteWithResults(sqlCommand)

public DataSet ExecuteWithResults(
    string sqlCommand
)

public:
DataSet^ ExecuteWithResults(
    String^ sqlCommand
)

member ExecuteWithResults : 
        sqlCommand:string -> DataSet

public function ExecuteWithResults(
    sqlCommand : String
) : DataSet

Parameters

• sqlCommand
  Type: System.String
  A String value that contains a Transact-SQL command.

Return Value

Type: System.Data.DataSet
A DataSet system object value that contains the returned results set.

Remarks

The results from this method are returned as a DataSet object. The DataSet object contains a collection of DataTable objects, from which the column and row information can be extracted.

Examples

VB

'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

ExecuteWithResults Overload

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Working with Database Objects

Creating, Altering, and Removing Databases

CREATE DATABASE (Transact-SQL)