CatalogManager3.CreateCategoryDefinition Method (PIA)

  • Article

Use this method to create a new category definition.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
…
Public Sub CreateCategoryDefinition(strDefinitionName As String)

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
…
public void CreateCategoryDefinition(stringstrDefinitionName);

Parameters

[Visual Basic .NET]

  • strDefinitionName
    A String that contains the name of the new category definition.

[C#]

  • strDefinitionName
    A string that contains the name of the new category definition.

Exceptions

This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.

The following table shows the custom COM errors that a COMException can wrap.

Name Value Description
E_CAT_CATMGR_NOT_INITIALIZED

[C#] 0x889800B

[Visual Basic .NET] &H8898005

 The CatalogManager object has not been initialized. The CatalogManager object should be initialized before calling this method
E_CAT_INVALID_DEFINITION_LENGTH

[C#] 0x889800E

[Visual Basic .NET] &H889800A

 The definition name that you specified is invalid. Definition names should be between 1 and 128 characters in length.
E_CAT_DEFINITION_EXISTS

[C#] 0x8898000

[Visual Basic .NET] &H889800A

 The Definition you specified already exists.
E_CAT_DEFN_NAME_EXISTS_AS_PRODUCT

[C#] 0x8898004

[Visual Basic .NET] &H8898004

 A product definition with the name you specified already exists. Definition names should be unique across Category and Product definitions.

Remarks

Category and product definition names must be globally unique across the entire Product Catalog System. It is not possible to have a category definition and a product definition with the same name.

The initial definition is empty when it is created. To add individual properties to the definition, use the AddDefinitionProperty method.

[Visual Basic .NET]

Example

myCatalogManager.CreateCategoryDefinition("Housewares")

Requirements

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)

See Also

CatalogManager3 Class

CatalogManager3.AddDefinitionProperty

CatalogManager3.CreateProductDefinition

CatalogManager3.DeleteDefinition

Copyright © 2005 Microsoft Corporation.
All rights reserved.