Save Method
Saves changes made to the current Advertisement object.
Namespace: Microsoft.CommerceServer.Marketing
Assembly: Microsoft.CommerceServer.Marketing.CrossTierTypes (in Microsoft.CommerceServer.Marketing.CrossTierTypes.dll)
Syntax
'Declaration
Public Overrides Sub Save ( _
forceOverwrite As Boolean _
)
'Usage
Dim instance As Advertisement
Dim forceOverwrite As Boolean
instance.Save(forceOverwrite)
public override void Save(
bool forceOverwrite
)
public:
virtual void Save(
bool forceOverwrite
) override
public override function Save(
forceOverwrite : boolean
)
Parameters
- forceOverwrite
Type: System..::.Boolean
Controls optimistic locking behavior. If the value is false and the record was modified in the database after it was loaded for editing, then an exception is raised.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | The xml serializable data received at the web service was nullNothingnullptra null reference (Nothing in Visual Basic). |
| ArgumentOutOfRangeException | The Id of the CampaignItem is less than zero. |
| NotAuthorizedException | The user is not authorized to perform the requested updates. |
| EntityDoesNotExistException | The ItemType is not a recognized campaign item type. |
| EntityStateException | The Advertisement cannot be modified because it has been deleted. |
| DuplicateEntityNameException | A campaign item with the specified Name already exists with in the context of the Campaign specified by CampaignName. |
| EnumeratedValueValidationException | An enumeration value of the Advertisement is not valid. |
| MaximumValueValidationException | One or more of the numeric property values of the current object was set to a value greater than the maximum allowed. |
| MinimumValueValidationException | One or more of the numeric property values of the current object was set to a value less than the minimum allowed. |
| OptimisticLockException | LastModifiedDate of the object was not set or the record was modified in the database since being loaded for editing. This exception is raised only if forceOverwrite is set to false |
| InvalidOperationException | An attempt was made to update the Active status of an existing Advertisement through the Save API. To update this status, please use Activate or Deactivate. |
Remarks
Saves changes to the database. Upon completion sets the HasChanges property to false.
Use forceOverwrite to prevent overwriting the object in the database. This will raise an exception if set to false and the record was modified in the database after it was loaded for editing.
Save can be used to add a new Advertisement to the database or update an existing Advertisement in the database.
Permissions
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.