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
public DataSet ExecuteWithResults (
string sqlCommand
)
public:
DataSet^ ExecuteWithResults (
String^ sqlCommand
)
public DataSet ExecuteWithResults (
String sqlCommand
)
public function ExecuteWithResults (
sqlCommand : String
) : DataSet
Parameters
- sqlCommand
A String value that contains a Transact-SQL command.
Return Value
A DataSet system object value that contains the returned results set.
Remarks
Updated text:17 July 2006
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.
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:
|