Data.Cloud.AmazonAPI.TAmazonTableService.InsertRow
Delphi
function InsertRow(const TableName, RowId: string; Row: TCloudTableRow; Conditionals: TList<TAmazonRowConditional>; ReplaceAll: Boolean = True; ResponseInfo: TCloudResponseInfo = nil): Boolean;
C++
bool __fastcall InsertRow(const System::UnicodeString TableName, const System::UnicodeString RowId, Data::Cloud::Cloudapi::TCloudTableRow* Row, System::Generics::Collections::TList__1<TAmazonRowConditional>* Conditionals, bool ReplaceAll = true, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Data.Cloud.AmazonAPI.pas Data.Cloud.AmazonAPI.hpp |
Data.Cloud.AmazonAPI | TAmazonTableService |
Description
Inserts a row into the given table.
Columns can contain multiple values. Use InsertRow to insert one or more name-value pairs where the names (which are the column names) are the same. Furthermore, values could already exist on the server for a specific column. If you do not set ReplaceAll to True, then any preexisting values for a column you specify will be preserved, and your new values will be added.
Note that, if columns exist on the server, but you do not specify them in this call, then they will remain on the server, regardless of the value of ReplaceAll.
Conditionals can only be used with single-values attributes.
The method returns True if the insertion is successful, and False otherwise.
The following table shows the significance of the parameters:
| Parameter | Description |
|---|---|
|
|
The name of the table to insert the row into. |
|
|
The unique ID of the row being inserted or updated. |
|
|
The row to insert or update. |
|
|
The conditionals for performing the insert, or nil. |
|
|
True to replace the values already stored for any specified column names. |
|
|
The optional class for storing response info into. |