ServerConnection.ExecuteNonQuery 方法 (String, ExecutionTypes)

發行項
04/22/2014

執行具有指定的執行選項而且不會傳回結果集的陳述式。

命名空間： Microsoft.SqlServer.Management.Common
組件： Microsoft.SqlServer.ConnectionInfo (在 Microsoft.SqlServer.ConnectionInfo.dll 中)

語法

'宣告
Public Function ExecuteNonQuery ( _
    sqlCommand As String, _
    executionType As ExecutionTypes _
) As Integer
'用途
Dim instance As ServerConnection 
Dim sqlCommand As String 
Dim executionType As ExecutionTypes 
Dim returnValue As Integer 

returnValue = instance.ExecuteNonQuery(sqlCommand, _
    executionType)

public int ExecuteNonQuery(
    string sqlCommand,
    ExecutionTypes executionType
)

public:
int ExecuteNonQuery(
    String^ sqlCommand, 
    ExecutionTypes executionType
)

member ExecuteNonQuery : 
        sqlCommand:string * 
        executionType:ExecutionTypes -> int

public function ExecuteNonQuery(
    sqlCommand : String, 
    executionType : ExecutionTypes
) : int

參數

sqlCommand
型別：String
String 值，指定要執行的 Transact-SQL 命令。

executionType
型別：Microsoft.SqlServer.Management.Common.ExecutionTypes
ExecutionTypes 物件值，指定 Transact-SQL 陳述式的執行選項。

傳回值

型別：Int32
Int32 值，指定受到 INSERT、UPDATE 和 DELETE 陳述式之 Transact-SQL 命令影響的資料列總數。對於所有其他類型的陳述式，傳回值為 -1。

備註

Transact-SQL 命令通常會影響伺服器的資料定義語言 (DDL) (DDL) 陳述式或預存程序。 CapturedSql 物件的 Text 屬性可用來作為 sqlCommand 參數允許一個擷取資料 Transact-SQL 陳述式的執行。 sqlCommand 參數包含單一 Transact-SQL 陳述式。

只有 SQLCMD 命令可 ExecuteNonQuery 方法辨識。如果 sqlCommand 參數包含非 SQLCMD 命令接著方法失敗或 ExecutionFailureException 例外狀況的陳述式，就會引發，除非設定 executionType 參數包含 ExecutionTypes.ContinueOnError 值。

範例

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Set the execution mode to CaptureSql for the connection.
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.CaptureSql
'Make a modification to the server that is to be captured.
srv.UserOptions.AnsiNulls = True
srv.Alter()
'Iterate through the strings in the capture buffer and display the captured statements.
Dim s As String
For Each s In srv.ConnectionContext.CapturedSql.Text
    Console.WriteLine(s)
Next
'Execute the captured statements.
srv.ConnectionContext.ExecuteNonQuery(srv.ConnectionContext.CapturedSql.Text)
'Revert to immediate execution mode. 
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.ExecuteSql

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server
$srv.ConnectionContext.SqlExecutionModes = [Microsoft.SqlServer.Management.Common.SqlExecutionModes]::CaptureSql
$srv.UserOptions.AnsiNulls = $TRUE
$srv.Alter()
foreach ($s in $srv.ConnectionContext.CapturedSql.Text)
{
   Write-Host $s
}
$srv.ConnectionContext.ExecuteNonQuery($srv.ConnectionContext.CapturedSql.Text)
$srv.ConnectionContext.SqlExecutionModes = [Microsoft.SqlServer.Management.Common.SqlExecutionModes]::ExecuteSql