Objet App pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Cette rubrique compare l'objet App dans Visual Basic 6.0 avec son équivalent dans Visual Basic 2008.
Dans Visual Basic 6.0, App est un objet global qui sert à définir et à récupérer des informations au sujet de l'application. Il n'existe aucun équivalent direct de l'objet App dans Visual Basic 2008. Toutefois, la plupart des propriétés, des méthodes et des événements peuvent être mappés sur des membres équivalents dans le .NET Framework.
Différences conceptuelles
Version Information, propriétés
Les propriétés Version Information de l'objet App sont remplacées par les attributs Assembly dans Visual Basic 2008. Les propriétés Version Information sont définies dans la boîte de dialogue Propriétés du projet. Les attributs Assembly sont définis dans la boîte de dialogue Informations de l'assembly qui est accessible en cliquant sur le bouton Informations de l'application sous l'onglet Application du Concepteur de projets.
.gif "Remarque") Remarque : |
|---|
Les propriétés Version Information sont stockées dans le fichier projet (.vbp) que vous pouvez modifier à l'aide d'un éditeur de texte tel que le Bloc-notes. Les attributs Assembly sont stockés dans le fichier AssemblyInfo.vb et peuvent être modifiés dans l'éditeur de code. |
File Description, propriété
Dans Visual Basic 6.0, l'objet App a les propriétés FileDescription et Title ; FileDescription détermine le texte de description qui apparaît dans l'Explorateur Windows.
Dans Visual Basic 2008, il n'existe aucun attribut FileDescription. À la place, l'attribut Title détermine le texte descriptif qui apparaît dans l'Explorateur Windows.
HelpFile, propriété
La propriété HelpFile dans Visual Basic 6.0 spécifie un fichier d'aide au niveau de l'application.
Dans Visual Basic 2008, les fichiers d'aide sont spécifiés formulaire par formulaire à l'aide d'un composant HelpProvider. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.
Version, propriétés
Les propriétés Major, Minor et Revision dans Visual Basic 6.0 sont utilisés pour retourner un numéro de version à trois parties pour une application.
Dans Visual Basic 2008, les informations de version incluent également une propriété Build et le numéro de version complet à quatre parties peut être récupéré à l'aide d'une propriété Version unique. Pour plus d'informations, consultez Numérotation des versions pour les utilisateurs de Visual Basic 6.0.
Title, propriété
La propriété Title de l'objet App dans Visual Basic 6.0 peut être modifiée par programme ; cela permet de déterminer le nom qui apparaît dans le Gestionnaire des tâches de Windows.
Dans Visual Basic 2008, l'attribut Title est en lecture seule. La propriété Text du formulaire principal de l'application détermine le nom qui est affiché dans le Gestionnaire des tâches. Vous pouvez définir la propriété Text par programme, mais le texte dans la barre de titre du formulaire est également modifié.
TaskVisible, propriété
Dans Visual Basic 6.0, la propriété TaskVisible de l'objet App détermine si une application apparaît dans la liste des tâches de Windows (Windows 9x) ou sous l'onglet Applications du Gestionnaire des Tâches (Windows 2000 ou version ultérieure). La propriété est couramment utilisée pour empêcher un utilisateur de fermer une application qui a été conçue pour s'exécuter comme tâche en arrière-plan. Dans la plupart des cas, la propriété TaskVisible est utilisée avec les applications qui n'affichent pas d'interfaces utilisateur.
Dans Visual Basic 2008, il n'existe pas d'équivalent de la propriété TaskVisible ; vous pouvez néanmoins créer un service Windows ou une application console qui n'apparaîtra pas dans la liste des tâches.
PrevInstance, propriété
La propriété PrevInstance dans Visual Basic 6.0 détermine si une instance de l'application est déjà en cours d'exécution. En général, vous devez appeler PrevInstance au démarrage de l'application, puis abandonner l'application si la valeur true est retournée.
Il n'existe aucun équivalent direct de PrevInstance dans Visual Basic 2008. Vous devez contrôler si plusieurs instances d'une application sont autorisées ou pas en définissant la propriété Plusieurs instances sur l'onglet Application du Concepteur de projets. Au moment de l'exécution, un événement NextInstanceStarted est déclenché lorsqu'un utilisateur essaie de démarrer une autre instance de l'application. Vous pouvez ajouter le code à ce gestionnaire d'événements pour activer la première instance de l'application.
Différences supplémentaires
Un certain nombre de propriétés de l'objet App dans Visual Basic 6.0 se rapportent aux composants ActiveX, à OLE automation, ainsi qu'à d'autres technologies qui sont désormais obsolètes et ne sont pas prises en charge dans Visual Basic 2008. Elles sont indiquées dans le tableau Équivalences des propriétés de l'objet App plus tard dans cette rubrique.
Modifications du code de l'objet App
Les exemples de code ci-dessous illustrent les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008 pour certaines utilisations courantes de l'objet App.
Modifications du code pour afficher le numéro de version d'une application
L'exemple suivant illustre la récupération du numéro de version d'une application et l'affichage de celui-ci dans une étiquette.
' Visual Basic 6.0
Label1.Caption = "Version: " & App.Major & "." & App.Minor & "." _
& App.Revision
' Visual Basic
Label1.Text = My.Application.Info.Version.ToString()
Modifications du code pour déterminer le chemin d'accès d'une application
L'exemple suivant illustre comment afficher un fichier image qui est stocké dans le dossier de l'application en récupérant le chemin d'accès vers l'application en cours d'exécution.
' Visual Basic 6.0
Picture1.Picture = LoadPicture(App.Path & "\Logo.jpg")
' Visual Basic
PictureBox1.Image = System.Drawing.Bitmap.FromFile( _
My.Application.Info.DirectoryPath & "\Logo.jpg")
Modifications du code pour empêcher une deuxième instance d'une application de s'exécuter
L'exemple suivant illustre l'implémentation d'une application à instance unique.
' Visual Basic 6.0
Private Sub Form_Load()
If App.PrevInstance = True Then
MsgBox("The application is already running!")
End If
End Sub
' Visual Basic
' Assumes that the Make Single Instance Application checkbox in the
' Project Designer has been checked.
Private Sub MyApplication_StartupNextInstance(ByVal sender As Object, _
ByVal e As Microsoft.VisualBasic.ApplicationServices. _
StartupNextInstanceEventArgs) Handles Me.StartupNextInstance
MsgBox("The application is already running!")
End Sub
Équivalents des propriétés de l'objet App
Le tableau ci-dessous répertorie toutes les propriétés et méthodes de l'objet App dans Visual Basic 6.0, ainsi que leurs équivalents dans Visual Basic 2008.
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||
|---|---|---|---|
Comments |
|||
CompanyName |
|||
EXEName |
|||
FileDescription |
|||
HelpFile |
Nouvelle implémentation. Utilisez un composant HelpProvider. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
HInstance |
|||
LegalCopyright |
|||
LegalTrademarks |
|||
LogEvent method |
|||
LogMode LogPath |
Nouvelle implémentation. Pour plus d'informations, consultez Enregistrement d'informations provenant de l'application. |
||
Major |
My.Application.Info.Version, propriété
|
||
Minor |
My.Application.Info.Version, propriété
|
||
NonModalAllowed |
Nouvelle implémentation. Il s'agit d'une propriété en lecture seule associée aux fichiers .dll ActiveX. Le Common Language Runtime gère automatiquement ce comportement. |
||
OleRequestPendingMsgText OleRequestPendingMsgTitle OleRequestPendingTimeout OleServerBusyMsgText OleServerBusyMsgTitle OleServerBusyRaiseError OleServerBusyTimeout |
Pas d'équivalent. Ces propriétés se rapportent à OLE automation, qui n'est pas pris en charge par Visual Basic 2008. |
||
Path |
|||
PrevInstance |
|
||
ProductName |
|||
RetainedProject |
Nouvelle implémentation. Visual Basic 2008 ne peut pas conserver un projet en mémoire. |
||
Revision |
My.Application.Info.Version, propriété
|
||
StartLogging method |
Nouvelle implémentation. Pour plus d'informations, consultez Enregistrement d'informations provenant de l'application. |
||
StartMode |
Pas d'équivalent. Cette propriété concerne la création de composants ActiveX, laquelle n'est pas prise en charge dans Visual Basic 2008. |
||
TaskVisible |
Nouvelle implémentation. Pour créer une application qui n'apparaît pas dans le Gestionnaire des tâches, créez un projet Service Windows ou Application console . |
||
ThreadID |
Nouvelle implémentation. Cette propriété a retourné l'ID du thread en cours d'exécution ; le modèle de thread est nettement différent dans Visual Basic 2008. |
||
Title |
|||
UnattendedApp |
Nouvelle implémentation. Pour les applications sans assistance dans Visual Basic 2008, créez un projet d'application console. |
Mettre à niveau des remarques
Lorsqu'une application est mise à niveau à partir de Visual Basic 6.0, seules les propriétés Major et Minor sont mises à niveau ; Visual Basic 2008 affecte de nouvelles valeurs aux propriétés Revision et Build.
Voir aussi
Concepts
Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0
Numérotation des versions pour les utilisateurs de Visual Basic 6.0