Build Method

  • Article

Rebuilds a project or creates an application (.app) file, executable (.exe) file, or dynamic-link library (.dll) from a Visual FoxPro project.

Object.Build([cOutputName] [, nBuildAction] [, lRebuildAll]   
[, lShowErrors] [, lBuildNewGUIDs])

Parameters

  • cOutputName
    Specifies the name of the .app, .exe, or .dll file to create.

    If cOutputName includes a file extension and nBuildAction is omitted, the file extension in cOutputName determines the type of file built. For example, if the extension in cOutputName is ".exe", an executable file is created.

  • nBuildAction
    Specifies that to rebuild a project or generate an .app, .exe, or .dll file. If nBuildAction is specified and cOutPutName does not include an extension, the appropriate extension is added.

    The following table lists the values for nBuildAction.

    nBuildAction FoxPro.h constant Description

    1

    BUILDACTION_REBUILD

    Rebuilds the project. (Default)

    2

    BUILDACTION_BUILDAPP

    Creates an .app file.

    3

    BUILDACTION_BUILDEXE

    Creates an .exe file.

    4

    BUILDACTION_BUILDDLL

    Creates a .dll file.

    5

    BUILDACTION_BUILDMTDLL

    Creates a multithreaded .dll file.

  • lRebuildAll
    Specifies whether to recompile files in the project before creating an .app, .exe, or .dll file.

    If lRebuildAll is True (.T.), the following files are recompiled:

    • Program files.

    • Format files.

    • Source code in forms, labels, reports, and visual class libraries.

    • Stored procedures in databases.

    If lRebuildAll is False (.F.) or is omitted, files in the project are not recompiled before creating the .app, .exe, or .dll file.

  • lShowErrors
    Specifies whether to display compilation errors in an editing window after the build completes.

    The following table describes the values for lShowErrors.

    lShowErrors Description

    True (.T.)

    Display errors in an editing window for an error (.err) file.

    False (.F.) or omitted

    Do not display errors.

  • lBuildNewGUIDs
    Specifies whether to generate new registry globally unique identifiers (GUIDs) when creating an .exe or .dll file.

    Note

    If nBuildAction is less than 3, Visual FoxPro disregards lBuildNewGUIDs.

    The following table describes values for lBuildNewGUIDs.

    lShowErrors Description

    True (.T.)

    Generate new GUIDs.

    False (.F.) or omitted

    Do not generate new GUIDs.

Return Value

Logical. Build returns True (.T.) if the project is successfully rebuilt or an .app, .exe, or .dll file successfully created without errors; otherwise Build returns False (.F.).

Remarks

Applies To: Project Object (Visual FoxPro)

See Also

Tasks

How to: Build Applications

Reference

BUILD APP Command
BUILD DLL Command
BUILD EXE Command
BUILD PROJECT Command
CREATE PROJECT Command
MODIFY PROJECT Command
Refresh Method (Visual FoxPro)

Other Resources

Methods (Visual FoxPro)
Language Reference (Visual FoxPro)