Section: User Commands (1)
Updated: 21 February 2006
Return to Main Contents
vbnc - Mono Visual Basic Compiler.
is a CIL compiler for the VisualBasic.NET language.
Applications developed on Windows with vbc can execute on Mono and applications
compiled with 'vbnc' can be executed on .NET runtime.
The Mono Visual Basic compiler accepts the same options as
the Microsoft VB.NET compiler. Those options can start with a slash or a
dash (/checked is the same as -checked).
Visual Basic.NET source files normally ends with a ".vb" extension.
Compilation of VB.NET source code requires all the files that make
up a library, module or executable to be provided on the command line.
There is no support for partial compilation. To achieve the benefits
of partial compilation, you should compile programs into their own
assemblies, and later reference them with the "-r" flag.
The Mono Basic compiler generates images (.exe files) that contain
CIL byte code that can be executed by any system that implements a Common
Language Infrastructure virtual machine such as the Microsoft .NET
runtime engine on Windows or the Mono runtime engine on Unix systems.
Executables are not bound to a specific CPU or operating system.
The Mono Basic compiler by default only references these assemblies:
mscorlib.dll, Microsoft.VisualBasic.dll, System.dll and System.Xml.dll.
If you want to reference extra libraries you must manually specify
them using the the -r: command line option.
Includes the specified modules in the resulting assembly.
Specifies the code page used to process the input files from the
point it is specified on. By default files will be processed in the
current code page. The compiler will also automatically detect
Unicode/UTF8 files that have an embedded byte mark at the beginning.
- Other popular encodings are 28591 (Latin1), 1252 (iso-8859-1) and 65001 (UTF-8).
- -define:SYMLIST, -d:SYMLIST
Defines the symbol listed by the semi-colon separeted list SYMLIST
SYMBOL. This can be tested in the source code by the pre-processor,
or can be used by methods that have been tagged with the Conditional
Specify the amount of debugging information to emit. Possible values for
AMOUNT are "full" and "pdbonly".
Declare global Imports for listed namespaces.
Ignores warning number XXXX.
- -lib:PATHLIST, -libpath:PATHLIST
Each path specified in the comma-separated list will direct the
compiler to look for libraries in that specified path.
Tells the compiler which CLASS or MODULE contains the entry point. Useful when
you are compiling several classes with a Main method.
Suppress printing copyright information on startup.
- -nostdlib, -nostdlib+
Use this flag if you want to compile the core library. This makes the
compiler load its internal types from the assembly being compiled.
- -noconfig, -noconfig+
Disables the default compiler configuration to be loaded. The
compiler by default has references to the system assemblies.
Makes the compiler ignore warnings.
- -optioncompare:binary, -optioncompare:text
Select between binary and text string comparisons. The default is binary
Require explicit declaration of variables
Enforce strict language semantics
- -out:FNAME, -o FNAME
Names the output file to be generated.
- -q -quiet
Commands the compiler to show only error messages for syntax-related errors
Embeds to the given resource file. The optional ID can be used to
give a different name to the resource. If not specified, the resource
name will be the file name.
Links to the specified RESOURCE. The optional ID can be used to give
a name to the linked resource.
- -r:ASSEMBLY1[,ASSEMBLY2], -r ASSEMBLY1[,ASSEMBLY2]
Reference the named assemblies. Use this to use classes from the named
assembly in your program. The assembly will be loaded from either the
system directory where all the assemblies live, or from the path
explicitly given with the -L option.
You can also use a semicolon to separate the assemblies instead of a
Remove integer checks. Default off.
Specifies the root namespace for all type declarations
- -target:KIND, -t:KIND
Used to specify the desired target. The possible values are: exe
(plain executable), winexe (Windows.Forms executable), library
(component libraries) and module (partial library).
Emit compiler output in UTF8 character encoding. Currently ignored.
Shows the compiler version.
- -warnaserror, -warnaserror+
Treat warnings as errors.
As of early 2007, the Mono Visual Basic compiler is still considered preview
software. The compiler is almost feature-complete (targeting the Microsoft
Visual Basic 8 compiler), only lacking support for the 'My' namespace.
Frequent crashes are still occuring, especially with incorrect code.
See the ChangeLog for authors
The Mono Visual Basic compiler is released under the terms of the GNU LGPL.
Alternative licenses are available from Novell.
mcs(1), mono(1), mint(1), sn(1)
To report bugs in the compiler, you can file bug reports in our
bug tracking system: http://bugzilla.ximian.com.
The Mono Basic Mailing List is available at: firstname.lastname@example.org
- SEE ALSO
- MAILING LIST
linux.jgfs.net manual pages