ConvertToBasket Method
For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.
Converts the current order template to a basket.
Namespace: Microsoft.CommerceServer.Runtime.Orders
Assembly: Microsoft.CommerceServer.Runtime (in Microsoft.CommerceServer.Runtime.dll)
Syntax
'Declaration
Public Function ConvertToBasket As Basket
'Usage
Dim instance As OrderTemplate
Dim returnValue As Basket
returnValue = instance.ConvertToBasket()
public Basket ConvertToBasket()
public:
Basket^ ConvertToBasket()
public function ConvertToBasket() : Basket
Return Value
Type: Microsoft.CommerceServer.Runtime.Orders..::.Basket
A newly-created Basket.
Exceptions
| Exception | Condition |
|---|---|
| OrderGroupConversionException | A OrderTemplate or a Basket has the same name but is of a different type. |
| InvalidOperationException | The current order template has been converted to a basket. No further operations are permited on this order template. You can, however, perform operations on the new basket. |
Remarks
Conversion rules:
Both strongly and weakly-typed properties on an OrderTemplate which have matching strongly-typed properties on a basket will be carried over as strongly-typed basket properties. Consider the example of two properties: prop1 and prop2. When defined on an OrderTemplate, "prop1" is strongly-typed and "prop2" is weakly-typed. When defined on a Basket, both "prop1" and "prop2" are strongly typed. A call to ConvertToBasket populates the strongly-typed properties of the basket with the data in the strongly- and weakly-typed properties of the OrderTemplate.
Both strongly and weakly-typed properties on an OrderTemplate which do not have matching strongly-typed properties on a basket will carried over as weakly-typed basket properties. Strongly-typed or weakly-typed properties in the OrderTemplate having no corresponding strongly-typed property name in the Basket will be added to the Basket as weakly-typed properties.
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.