Build Method

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)