ServerConnection.ExecuteNonQuery Method (String, ExecutionTypes)

Article
12/15/2008

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

Espace de noms: Microsoft.SqlServer.Management.Common
Assembly: Microsoft.SqlServer.ConnectionInfo (in microsoft.sqlserver.connectioninfo.dll)

Syntaxe

'Déclaration
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

Paramètres

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.

Valeur de retour

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.

Notes

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.

Cet espace de noms, cette classe ou ce membre est pris en charge uniquement par la version 2.0 de Microsoft .NET Framework.

Sécurité des threads

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.

Plateformes

Plateformes de développement

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Plateformes cibles

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Voir aussi

Référence

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

Autres ressources

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

Partager via