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

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.

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.

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.