ServerConnection.ExecuteNonQuery 메서드 (String)
결과 집합을 반환하지 않는 문을 실행합니다.
네임스페이스: Microsoft.SqlServer.Management.Common
어셈블리: Microsoft.SqlServer.ConnectionInfo(Microsoft.SqlServer.ConnectionInfo.dll)
구문
‘선언
Public Function ExecuteNonQuery ( _
sqlCommand As String _
) As Integer
‘사용 방법
Dim instance As ServerConnection
Dim sqlCommand As String
Dim returnValue As Integer
returnValue = instance.ExecuteNonQuery(sqlCommand)
public int ExecuteNonQuery(
string sqlCommand
)
public:
int ExecuteNonQuery(
String^ sqlCommand
)
member ExecuteNonQuery :
sqlCommand:string -> int
public function ExecuteNonQuery(
sqlCommand : String
) : int
매개 변수
- sqlCommand
유형: String
실행할 Transact-SQL 명령을 지정하는 String 값입니다.
반환 값
유형: Int32
UPDATE, INSERT 및 DELETE 문의 Transact-SQL 명령이 적용된 총 행 수를 지정하는 Int32 값입니다.모든 다른 유형의 문인 경우 반환 값은 -1입니다.
주의
Transact-SQL명령은 일반적으로데이터 정의언어 (DDL) 문 또는저장 프로시저는 서버 설정에 영향을 줍니다. Text속성의 CapturedSql로 개체를 사용할 수는 sqlCommand는 캡처된의 실행을 허용 하도록 매개 변수 Transact-SQL문. sqlCommand매개 변수에 포함 된 단일 Transact-SQL문.
SQLCMD 명령에 의해 인식 되는 ExecuteNonQuery메서드. 경우는 sqlCommand매개 변수 그건 하지 SQLCMD 명령메서드실패 후 고 문을 포함 ExecutionFailureException예외가 발생 합니다.
예
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
참고 항목
참조
Microsoft.SqlServer.Management.Common 네임스페이스