ADO.NET Provider for Microsoft Dynamics 365

Build 23.0.8839

INSERT Statements

To create new records, use INSERT statements.


The INSERT statement specifies the columns to be inserted and the new column values. You can specify the column values in a comma-separated list in the VALUES clause, as shown in the following example:

INSERT INTO <table_name> 
( <column_reference> [ , ... ] )
( { <expression> | NULL } [ , ... ] ) 

<expression> ::=
  | @ <parameter> 
  | ?
  | <literal>

You can use the ExecuteNonQuery method to execute data manipulation commands and retrieve the rows affected, as shown in the following example:


String connectionString = "InitiateOAuth=GETANDREFRESH;OrganizationUrl=;Edition=Sales;";
using (Dynamics365Connection connection = new Dynamics365Connection(connectionString)) {
  int rowsAffected;
  Dynamics365Command cmd = new Dynamics365Command("INSERT INTO GoalHeadings (GoalHeadingId) VALUES ('John')", connection);
  rowsAffected = cmd.ExecuteNonQuery();


Dim connectionString As [String] = "InitiateOAuth=GETANDREFRESH;OrganizationUrl=;Edition=Sales;"
Using connection As New Dynamics365Connection(connectionString)
  Dim rowsAffected As Integer
  Dim cmd As New Dynamics365Command("INSERT INTO GoalHeadings (GoalHeadingId) VALUES ('John')", connection)
  rowsAffected = cmd.ExecuteNonQuery()
End Using

Retrieving Generated Ids

In order to retrieve the GoalHeadingId of the last inserted record, use the SCOPE_IDENTITY function, as shown in the following example:


cmd = connection.CreateCommand();
cmd.CommandText = "SELECT SCOPE_IDENTITY()";
Object returnedValues = cmd.ExecuteScalar();
String GoalHeadingId = (String)returnedValues;


cmd = connection.CreateCommand()
cmd.CommandText = "SELECT SCOPE_IDENTITY()"
Dim returnedValues As [Object] = cmd.ExecuteScalar()
Dim GoalHeadingId As [String] = returnedValues 

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 23.0.8839