Database.ExecuteWithResults Method (StringCollection)

Article
12/03/2008

Executes a batch 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 ( _
    sqlCommands As StringCollection _
) As DataSet

public DataSet ExecuteWithResults (
    StringCollection sqlCommands
)

public:
DataSet^ ExecuteWithResults (
    StringCollection^ sqlCommands
)

public DataSet ExecuteWithResults (
    StringCollection sqlCommands
)

public function ExecuteWithResults (
    sqlCommands : StringCollection
) : DataSet

Parameters

sqlCommands
A StringCollection System object value that contains more than one Transact-SQL command.

Return Value

A DataSet system object value that contains the returned results set.

Remarks

Updated text:17 July 2006

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