ServerConnection.ExecuteNonQuery 메서드 (String, ExecutionTypes)

Executes a statement with the specified execution options that does not return a result set.

네임스페이스:  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
    유형: System.String
    A String value that specifies the Transact-SQL command to be executed.

반환 값

유형: System.Int32
An Int32 value that specifies the total number of rows affected by the Transact-SQL command for UPDATE, INSERT, and DELETE statements. For all other types of statements, the return value is -1.

주의

The Transact-SQL command is typically a data definition language (DDL) statement or stored procedure that affects the server settings. The Text property of the CapturedSql object can be used as the sqlCommand parameter to allow execution of a captured Transact-SQL statement. The sqlCommand parameter contains a single Transact-SQL statement.

Only SQLCMD commands are recognized by the ExecuteNonQuery method. If the sqlCommand parameter contains a statement that is not a SQLCMD command then the method fails and an ExecutionFailureException exception is raised, unless the executionType parameter has been set to include the ExecutionTypes.ContinueOnError value.

VB

'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

참고 항목

참조

ServerConnection 클래스

ExecuteNonQuery 오버로드

Microsoft.SqlServer.Management.Common 네임스페이스

관련 자료

캡처 모드 사용