UPDATE Statements
To modify existing records, use UPDATE statements.
Update Syntax
The UPDATE statement takes as input a comma-separated list of columns and new column values as name-value pairs in the SET clause, as shown in the following example:
UPDATE <table_name> SET <select_statement> | {<column_reference> = <expression> [ , ... ]} WHERE { Id = <expression> } [ { AND | OR } ... ]
<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:
C#
String connectionString = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;"; using (SmartsheetConnection connection = new SmartsheetConnection(connectionString)) { int rowsAffected; SmartsheetCommand cmd = new SmartsheetCommand("UPDATE Sheet_Test_Sheet SET Name='Basic Agile Project with Gantt Timeline' WHERE Id = @myId", connection); cmd.Parameters.Add(new SmartsheetParameter("myId","123456")); rowsAffected = cmd.ExecuteNonQuery(); }
VB.NET
Dim connectionString As [String] = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;" Using connection As New SmartsheetConnection(connectionString) Dim rowsAffected As Integer Dim cmd As New SmartsheetCommand("UPDATE Sheet_Test_Sheet SET Name='Basic Agile Project with Gantt Timeline' WHERE Id = @myId", connection) cmd.Parameters.Add(New SmartsheetParameter("myId", "123456")) rowsAffected = cmd.ExecuteNonQuery() End Using