`create()`

Description

Creates a new object, saves it to the database (if the validation permits it), and returns it. If the validation fails, the unsaved object (with errors added to it) is still returned. Property names and values can be passed in either using named arguments or as a struct to the properties argument.

Function Syntax

create([ properties, parameterize, reload, transaction, callbacks ])

Parameters

Parameter	Type	Required	Default	Description
`properties`	`struct`	No	`[runtime expression]`	The properties you want to set on the object (can also be passed in as named arguments).
`parameterize`	`any`	No	`true`	Set to `true` to use `cfqueryparam` on all columns, or pass in a list of property names to use `cfqueryparam` on those only.
`reload`	`boolean`	No	`false`	Set to `true` to reload the object from the database once an insert/update has completed.
`transaction`	`string`	No	`[runtime expression]`	Set this to `commit` to update the database when the save has completed, `rollback` to run all the database queries but not commit them, or `none` to skip transaction handling altogether.
`callbacks`	`boolean`	No	`true`	Set to `false` to disable callbacks for this operation.

Examples

<!--- Create a new author and save it to the database --->
<cfset newAuthor = model("author").create(params.author)>

<!--- Same as above using named arguments --->
<cfset newAuthor = model("author").create(firstName="John", lastName="Doe")>

<!--- Same as above using both named arguments and a struct --->
<cfset newAuthor = model("author").create(active=1, properties=params.author)>

<!--- If you have a `hasOne` or `hasMany` association setup from `customer` to `order`, you can do a scoped call. (The `createOrder` method below will call `model("order").create(customerId=aCustomer.id, shipping=params.shipping)` internally.) --->
<cfset aCustomer = model("customer").findByKey(params.customerId)>
<cfset anOrder = aCustomer.createOrder(shipping=params.shipping)>