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.

See Also

Reference

VirtualCatalog Class

VirtualCatalog Members

Microsoft.CommerceServer.Catalog Namespace