-vbruntime

Article
06/05/2023

Spécifie que le compilateur doit compiler sans référence à la bibliothèque runtime Visual Basic, ou avec une référence à une bibliothèque runtime spécifique.

Syntaxe

-vbruntime:{ - | + | * | path }

Arguments

-
Compilez sans référence à la bibliothèque Runtime Visual Basic.

+
Compilez avec une référence à la bibliothèque Runtime Visual Basic par défaut.

*
Compilez sans référence à la bibliothèque Runtime Visual Basic et incorporez les fonctionnalités principales de la bibliothèque Runtime Visual Basic dans l’assembly.

path
Compilez avec une référence à la bibliothèque spécifiée (DLL).

Notes

Vous pouvez spécifier que le compilateur doit compiler sans référence à la bibliothèque Runtime Visual Basic à l’aide de l’option du compilateur -vbruntime. Si vous compilez sans référence à la bibliothèque Runtime Visual Basic, des erreurs ou des avertissements sont enregistrés sur le code ou les constructions de langage qui génèrent un appel à une assistance du runtime Visual Basic. (Une assistance du runtime Visual Basic est une fonction définie dans Microsoft.VisualBasic.dll appelée au moment de l’exécution pour exécuter une sémantique de langage spécifique.)

L’option -vbruntime+ génère le même comportement que celui qui se produit si aucun commutateur -vbruntime n’est spécifié. Vous pouvez utiliser l’option -vbruntime+ pour remplacer les commutateurs -vbruntime précédents.

La plupart des objets du type My ne sont pas disponibles lorsque vous utilisez les options -vbruntime- ou -vbruntime:path.

Incorporation des fonctionnalités principales du Runtime Visual Basic

L’option -vbruntime* vous permet de compiler sans référence à une bibliothèque d’exécution. Au lieu de cela, les fonctionnalités principales de la bibliothèque Runtime Visual Basic sont incorporées dans l’assembly utilisateur. Vous pouvez utiliser cette option si votre application s’exécute sur des plateformes qui ne contiennent pas le runtime Visual Basic.

Les membres du runtime suivants sont incorporés :

Classe Conversions
Méthode AscW(Char)
Méthode AscW(String)
Méthode ChrW(Int32)
vbBack constant
vbCr constant
vbCrLf constant
vbFormFeed constant
vbLf constant
vbNewLine constant
vbNullChar constant
vbNullString constant
vbTab constant
vbVerticalTab constant
Certains objets du type My

Si vous compilez à l’aide de l’option -vbruntime* et que votre code référence un membre à partir de la bibliothèque Runtime Visual Basic qui n’est pas incorporée avec les fonctionnalités principales, le compilateur retourne une erreur qui indique que le membre n’est pas disponible.

Référencement d’une bibliothèque spécifiée

Vous pouvez utiliser l’argument path pour compiler avec une référence à une bibliothèque runtime personnalisée au lieu de la bibliothèque Runtime Visual Basic par défaut.

Si la valeur de l’argument path est un chemin d’accès complet à un DLL, le compilateur utilise ce fichier comme bibliothèque runtime. Si la valeur de l’argument path n’est pas un chemin d’accès complet à un DLL, le compilateur Visual Basic recherche d’abord le DLL identifié dans le dossier actif. Il effectue ensuite une recherche dans le chemin que vous avez spécifié à l’aide de l’option du compilateur -sdkpath. Si l’option -sdkpath du compilateur n’est pas utilisée, le compilateur recherche le DLL identifié dans le dossier .NET Framework (%systemroot%\Microsoft.NET\Framework\versionNumber).

Exemple

L’exemple suivant montre comment utiliser l’option -vbruntime pour compiler avec une référence à une bibliothèque personnalisée.

vbc -vbruntime:C:\VBLibraries\CustomVBLibrary.dll

Partager via