RuntimeState Class |  |
Container Class that holds the XSharp Runtime state
Inheritance HierarchyNamespace: XSharp
Assembly: XSharp.Core (in XSharp.Core.dll) Version: 2.19
SyntaxThe RuntimeState type exposes the following members.
Properties| Name | Description | |
|---|---|---|
  | Alternate | The current Alternate setting. |
| AltFile | The current AltFile setting. |
| Ansi | The current ANSI setting |
| AppModule | The System.Reflection.Module for the main application. |
| AutoOpen | The current AutoOpen setting (used by the RDD system). |
| AutoOrder | The current AutoOrder setting (used by the RDD system). |
| AutoShareMode | The current AutoShareMode setting (used by the RDD system). |
| BreakLevel | Current Break Level. Gets set by compiler generated code for BEGIN SEQUENCE .. END constructs. |
| Century | The current Century setting (used in DATE <-> STRING conversions). |
| CollationMode | The current Collation mode (used by the RDD system). |
| CollationTable | Current collation table. |
| Compatible | The current Compatible setting. |
| CompilerOptionFOVF | The current compiler setting for the FOVF compiler option. |
| CompilerOptionFox2 | The current compiler setting for the VO13 compiler option. |
| CompilerOptionOVF | The current compiler setting for the OVF compiler option. |
| CompilerOptionVO11 | The current compiler setting for the VO11 compiler option. |
| CompilerOptionVO13 | The current compiler setting for the VO13 compiler option. |
| Console | The current Console setting. |
| CurrentWorkarea | Gets / Sets the current Workarea number. |
| DataSession | The DataSession information for the current Thread. |
| DateCountry | The current DateCountry setting mode (used in DATE <-> STRING conversions). |
| DateFormat | The current Date format |
| Decimals | The default number of decimals for new FLOAT values that are created without explicit decimals. |
| DecimalSep | The default number of decimals for new FLOAT values that are created without explicit decimals. |
| DefaultRDD | The default RDD. |
| Deleted | RDD Deleted Flag that determines whether to ignore or include records that are marked for deletion. |
| DelimRDD | Name of the RDD uses for DELIM operations. |
| Dialect | |
| Digits | The default number of digits for new FLOAT values that are created without explicit decimals |
| DigitsFixed | Logical setting that fixes the number of digits used to display numeric output. |
| DosCodePage | The 'DOS' Codepage. This gets read at startup from the OS(). |
| DosEncoding | The DOS Encoding. This is based on the corrent DOS Codepage. |
| Eof | Should text files, such as memo files be written with a closing EOF = chr(26) character. |
| Eol | End of line character to be used by the runtime. Defaults to CR + LF (13 + 13). |
| Epoch | Date Epoch value that determines how dates without century digits are interpreted. |
| EpochCent | Date Epoch Century value. This gets set by the SetEpoch() function to the century in which the Epoch year falls. |
| EpochYear | Date Epoch Year value. This gets set by the SetEpoch() function to the Epoch year % 100. |
| Exact | String comparison Exact flag that determines how comparisons with the single '=' characters should be done. |
| FieldDelimiter | Field delimiters for DELIM operations. |
| FileError | The last File IO error number |
| FileException | The last file IO Exception |
| Fixed | Logical setting that fixes the number of decimal digits used to display numbers. |
| FloatDelta | Numeric value that controls the precision of Float comparisons. |
| HPLocking | The setting that determines whether to use the High Performance (HP) locking schema for newly created .NTX files |
| International | Current SetInternational Setting. |
| LastFound | The last file found with File(). This is the name that FPathName() returns. |
| LastRddError | Last error that occurred in the RDD subsystem. |
| LastScriptError | Last Script error that occurred . |
| LockTries | Number of tries that were done when the last lock operation failed. |
| MacroCompiler | Active Macro compiler |
| MacroCompilerIncludeAssemblyInCache |
This property allows you to override the mechanism that decided if the types in an assembly should be cached
The default behavior is that every assembly that is found is cached.
|
| MacroResolver | Active Macro compiler |
| MemoBlockSize | The current default MemoBlock size. |
| Name | Retrieve state name |
| NetErr | Did the last RDD operation cause a Network Error ? |
| NewIndexLock | The setting that determines whether to use the new locking offset of -1 (0xFFFFFFFF) for .NTX files. |
| NoMethod | The name of the method that was called in the last late bound method call. |
| NullDateString | A cached copy of the string that is returned for empty dates, matching the current DateFormat |
| Optimize | RDD Optimize Flag |
| Refresh | The current SetRefresh flag. |
| RunningOnWindows | |
| Safety | The current SetSafety flag. |
| ScriptCompiler | Active Script compiler. Gets assigned from the ExecScriptFast() function. |
| Settings | The dictionary that stores most of the settings in the runtime state. The key to the index is the number from the Set Enum |
| SoftSeek | The current SetSoftSeek flag. |
| StringDelimiter | String delimiters for DELIM operations. |
| ThousandSep | The Thousand separator |
| Unique | Should indexes by default be created with the 'Unique setting'. |
| WinCodePage | The Windows Codepage. This gets read at startup from the OS(). |
| WinEncoding | The Windows Encoding. This is based on the corrent Win Codepage. |
| Workareas | The Workarea information for the current Thread. |
Methods| Name | Description | |
|---|---|---|
 | GetInstance | Retrieve the runtime state for the current thread |
| GetValueT | Retrieve a value from the state of the current Thread. |
| SetDataSession | This method can be used to switch the active DataSession in the runtime state. |
| SetValueT | Set a value for the state of the current Thread. |
| StringCompare(String, String) |
Compare 2 strings. This function is used by the compiler for string comparisons.
|
| StringCompare(Byte, Byte, Long) | Compare 2 byte arrays respecting the runtime string comparison rules. |
| StringCompareCollation |
Compare 2 strings. This function is used by the compiler for string comparisons.
|
| ToString | ToString() override (Overrides ToString.) |
Events| Name | Description | |
|---|---|---|
 | DialectChanged | This event is invoked when the runtime dialect is changed. |
| OnCodePageChanged | This event is thrown when one of the codepages of the runtimestate is changed |
| OnCollationChanged | This event is thrown when the collation of the runtimestate is changed |
| StateChanged | This event is invoked when the runtime state is changed. |
Fields| Name | Description | |
|---|---|---|
 | AutoLock | Delegate that gets called to automatically lock a record in the FoxPro dialect. |
| AutoUnLock | Delegate that gets called to automatically unlock a record in the FoxPro dialect. |
Remarks
Please note that unlike in most XBase products every thread has its own copy of the runtime state.
The runtime state from a new thread is a copy of the state of the main thread at that moment.
The runtime state from a new thread is a copy of the state of the main thread at that moment.
See Also