ConvertToAreaDatabase()

Summary

Creates an area geographic file from a set of line or area features.

Syntax

ConvertToAreaDatabase(string layer_set, string new_db_name, array options)

Argument Contents
layer_set The name of the layer or selection set
new_db_name The path and file name of the new geographic file
Option Type Contents
Label String A descriptive label for the geographic file
Layer Name String The name of the layer in the geographic file

Notes

  • The new geographic file:

    • Has one feature for each closed polygon created by the lines or boundary edges in the input layer or selection set.

    • Is always a standard format file with a .DBD extension.

    • Is automatically optimized.

  • ConvertToAreaDatabase() requires substantial amounts of memory. If the available memory is insufficient, the system is often left unstable.

  • ConvertToAreaDatabase() displays a progress bar. To add a Cancel button to the progress bar, precede the function call with an "on escape" clause. For more information, see Error Handling.

Example

ConvertToAreaDatabase("Highways|Interstates", "zones.dbd", {
{"Label", "Zones Bordered by Highways"},
{"Layer Name", "Zones"}
})

Error Codes

Error Type Meaning
Error The layer or set name or one of the options is invalid
Escape The user clicked Cancel

See Also

Function Summary
ConvertToLineDatabase() Creates a line geographic file from a set of line or area features
ExportGeography() Converts a geographic file between standard and compact format, or creates a new geographic file from a selection set