| Tag Link | [Include_Once] | Category | Include |
|---|---|---|---|
| Type | Substitution | Source Available | Yes |
| Support | Preferred | Version | 8.5 |
| Change | New | Data Source | Any |
| Output Type | String | Security | None |
| Implementation | Internal | Sets | Lasso 8.5 |
[Include_Once] inserts the specified format file into the current format file. Any Lasso code in the included format file is executed as if were placed in the current format file at the location of the [Include_Once] tag.
Accepts a single parameter, the name of the format file to be included.
If [Include_Once] is used multiple times referencing the same Lasso page then only the first [Include_Once] will actually perform the include. Subsequent [Include_Once] tags which reference the same file will do nothing.
Container tags cannot be started within one file and closed in the other, but the [Include] tag can be contained within container tags which are opened and closed within the same format file.
Note: [Loop_Count] cannot be used within an include file to get the current repetition of a container tag around the [Include_Once] tag. Instead, store the loop count in a variable.
[Include_Once: 'File Path']
| Required Parameters | |
|---|---|
| File Name | The name of the file to be included. |
See the Lasso 8 Language Guide for examples of how to use this tag.