Category3.ChildCategories Property (PIA)

Article
11/12/2009

The ChildCategories property is a read-only Recordset object that contains the names of categories that exist below this category in the hierarchy.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
…
Public Property ChildCategories As _Recordset

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
using ADODB26Lib;                              //For _Recordset
…
public _Recordset CategoryName {get;}

Parameters

[C#]

An ADODB26Lib._Recordset interface to a Recordset object used to return the child categories.

Exceptions

This property 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.

Constant	Value	Description
E_CAT_INVALID_RS_POINTER	[C#] 0x889800B7 [Visual Basic .NET] &H889800B7	The recordset pointer that you specified is invalid

E_CAT_INVALID_RS_POINTER

[C#] 0x889800B7

[Visual Basic .NET] &H889800B7

The recordset pointer that you specified is invalid

Remarks

The **ChildCategories****property contains valid data only if the property is accessed successfully.

The ChildCategories recordset contains a row for each of the categories that are currently children of this category. The following table lists the fields for the ChildCategories recordset.

Field	Data type	Description
CategoryName	String maximum of 128 characters	The name of the category.
DefinitionName	String maximum of 128 characters	The name of the definition.
CatalogName	String maximum of 128 characters	The name of the catalog that contains the category.
DisplayName	String maximum of 128 characters	The display name of the category.

If this category has no children, an empty recordset is returned whose EOF property is set to true. Your code should check the value of this property to determine if child categories exist.

Requirements

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)

Share via