AddPriceRule Method
Adds a pricing rule from a base catalog to the virtual catalog.
Namespace: Microsoft.CommerceServer.Catalog
Assembly: Microsoft.CommerceServer.Catalog (in Microsoft.CommerceServer.Catalog.dll)
Syntax
'Declaration
Public Sub AddPriceRule ( _
catalogName As String, _
categoryName As String, _
productId As String, _
variantId As String, _
priceChangeType As CatalogPricingRuleType, _
priceChange As Decimal _
)
'Usage
Dim instance As VirtualCatalog
Dim catalogName As String
Dim categoryName As String
Dim productId As String
Dim variantId As String
Dim priceChangeType As CatalogPricingRuleType
Dim priceChange As Decimal
instance.AddPriceRule(catalogName, categoryName, _
productId, variantId, priceChangeType, _
priceChange)
public void AddPriceRule(
string catalogName,
string categoryName,
string productId,
string variantId,
CatalogPricingRuleType priceChangeType,
decimal priceChange
)
public:
void AddPriceRule(
String^ catalogName,
String^ categoryName,
String^ productId,
String^ variantId,
CatalogPricingRuleType priceChangeType,
Decimal priceChange
)
public function AddPriceRule(
catalogName : String,
categoryName : String,
productId : String,
variantId : String,
priceChangeType : CatalogPricingRuleType,
priceChange : decimal
)
Parameters
- catalogName
Type: System..::.String
The base catalog to add the rule from.
- categoryName
Type: System..::.String
The category name in the base catalog.
- productId
Type: System..::.String
The product identifier for the product in the base catalog.
- variantId
Type: System..::.String
The variant identifier for the product in the base catalog.
- priceChangeType
Type: Microsoft.CommerceServer.Catalog..::.CatalogPricingRuleType
The price rule type.
- priceChange
Type: System..::.Decimal
The price rule amount.
Exceptions
Exception | Condition |
---|---|
ValidationException | The rule is invalid. |
RuleAlreadyExistsException | The price rule already exists. |
Remarks
Use this method to add price rules from one or more base catalogs to this virtual catalog. A catalog level price rule will always be applied to all the catalog items included from the base catalog. However, if additional category, product or variant level price rules are also specified, these prices rules will override the catalog level price rule. When a rule is added from a base catalog to the virtual catalog the catalogName is added as a dependent catalog of the virtual catalog. Call the Save method to save the changes to the catalog system. Call the Rebuild method to apply the rules to the virtual catalog.
You can specify four types of price rules:
AddFixedAmount - Adds the amount specified by priceChange to the price of the catalog item in the base catalog.
NoPriceChange - The price of the catalog item in the base catalog remains unchanged.
PercentageMultiplier - Adds the percentage amount specified by priceChange to the price of the catalog item in the base catalog. The priceChange can be less than zero to discount the price of the catalog item in the base catalog.
ReplacePrice - Sets the price of the catalog item in the base catalog to priceChange to the price of the product in the base catalog.
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.