DataContext.ExecuteCommand(String, Object[]) DataContext.ExecuteCommand(String, Object[]) DataContext.ExecuteCommand(String, Object[]) DataContext.ExecuteCommand(String, Object[]) Method

정의

데이터베이스에 대해 직접 SQL 명령을 실행합니다.Executes SQL commands directly on the database.

public:
 int ExecuteCommand(System::String ^ command, ... cli::array <System::Object ^> ^ parameters);
public int ExecuteCommand (string command, params object[] parameters);
member this.ExecuteCommand : string * obj[] -> int
Public Function ExecuteCommand (command As String, ParamArray parameters As Object()) As Integer

매개 변수

command
String String String String

실행할 SQL 명령입니다.The SQL command to be executed.

parameters
Object[]

명령에 전달할 매개 변수 배열입니다.The array of parameters to be passed to the command. 다음 동작에 유의하세요.Note the following behavior: 배열의 개체 수가 명령 문자열에 지정된 최대 개수보다 작으면 예외가 throw됩니다.If the number of objects in the array is less than the highest number identified in the command string, an exception is thrown.

명령 문자열에서 참조되지 않은 개체가 배열에 있는 경우에는 예외가 throw되지 않습니다.If the array contains objects that are not referenced in the command string, no exception is thrown.

null인 매개 변수는 DBNull.Value로 변환됩니다.If any one of the parameters is null, it is converted to DBNull.Value.

반환

명령을 실행하여 수정된 행 수입니다.The number of rows modified by the executed command.

예제

db.ExecuteCommand("UPDATE Products SET UnitPrice = UnitPrice + 1.00");
    db.ExecuteCommand _
("UPDATE Products SET UnitPrice = UnitPrice + 1.00")

설명

이 메서드는 사례에 대 한 통과 메커니즘 여기서 LINQ to SQLLINQ to SQL 특정 시나리오에 적절 하 게 제공 하지 않습니다.This method is a pass-through mechanism for cases where LINQ to SQLLINQ to SQL does not adequately provide for a particular scenario.

명령에 대 한 구문은 ADO.NET을 만드는 데 구문과 거의 동일 DataCommand합니다.The syntax for the command is almost the same as the syntax used to create an ADO.NET DataCommand. 유일한 차이점은 매개 변수를 지정 하는 방법을 합니다.The only difference is in how the parameters are specified. 중괄호 ({...})로 묶어 매개 변수를 지정 하 고 열거 해야 하는 구체적으로 0에서 시작 합니다.Specifically, you specify parameters by enclosing them in braces ({…}) and enumerate them starting from 0. 매개 변수가 매개 변수 배열에서 동일 하 게 번호가 매겨진된 개체와 연결 됩니다.The parameter is associated with the equally numbered object in the parameters array.

ExecuteQueryExecuteCommand 가변 매개 변수 대체에 대 한 인수를 지정할 수 있습니다.ExecuteQuery and ExecuteCommand allow you to specify a variable number of arguments for parameter substitution. 예를 들어, ExecuteQuery를 호출 하는 경우 매개 변수를 지정할 수 있습니다<TResult >:For example, you can specify the parameters when invoking ExecuteQuery<TResult>:

db.ExecuteQuery<Customer>("select * from dbo.Customers where City = {0}", "London");  

와 다른 예제:And, another example:

db.ExecuteCommand("UPDATE Products SET QuantityPerUnit = {0} WHERE ProductID = {1}", "24 boxes", 5);  

다음 예제에서는 연결을 열고 SQL 전달 UPDATE SQL 엔진에 명령 합니다.The following example opens a connection and passes a SQL UPDATE command to the SQL engine.

적용 대상