ServerConnection.ExecuteNonQuery Method (String, ExecutionTypes)

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

네임스페이스: Microsoft.SqlServer.Management.Common
어셈블리: Microsoft.SqlServer.ConnectionInfo (in microsoft.sqlserver.connectioninfo.dll)

구문

‘선언
Public Function ExecuteNonQuery ( _
    sqlCommand As String, _
    executionType As ExecutionTypes _
) As Integer
public int ExecuteNonQuery (
    string sqlCommand,
    ExecutionTypes executionType
)
public:
int ExecuteNonQuery (
    String^ sqlCommand, 
    ExecutionTypes executionType
)
public int ExecuteNonQuery (
    String sqlCommand, 
    ExecutionTypes executionType
)
public function ExecuteNonQuery (
    sqlCommand : String, 
    executionType : ExecutionTypes
) : int

매개 변수

  • sqlCommand
    A String value that specifies the Transact-SQL command to be executed.
  • executionType
    An ExecutionTypes object value that specifies the execution options for the Transact-SQL statement.

반환 값

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.

이 네임스페이스, 클래스 또는 멤버는 Microsoft .NET Framework 2.0 버전에서만 지원됩니다.

스레드 보안

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.

플랫폼

개발 플랫폼

지원되는 플랫폼 목록은 SQL Server 2005 설치를 위한 하드웨어 및 소프트웨어 요구 사항을 참조하십시오.

대상 플랫폼

지원되는 플랫폼 목록은 SQL Server 2005 설치를 위한 하드웨어 및 소프트웨어 요구 사항을 참조하십시오.

참고 항목

참조

ServerConnection Class
ServerConnection Members
Microsoft.SqlServer.Management.Common Namespace

관련 자료

How to: Enable Capture Mode in Visual Basic .NET
Using Capture Mode