Objeto App para usuários do Visual Basic 6.0
Este tópico compara o Visual Basic 6.0 App objeto com seu equivalente em Visual Basic 2008.
The App objeto no Visual Basic 6.0 é um objeto global usado para conjunto ou recuperar informações sobre o aplicativo. Não há nenhum equivalente direto para o App objeto em Visual Basic 2008. Entretanto, a maioria das propriedades, métodos e eventos pode ser mapeada para membros equivalentes no .NET Framework.
Diferenças Conceituais
Propriedades de Version Information
The App objeto Version Information propriedades são substituídos por Assembly atributos em Visual Basic 2008. Version Information as propriedades são definidas no Propriedades do projeto caixa de diálogo.Assembly atributos são definidos na Informações de assembly a caixa de diálogo, o que está disponível clicando-se a Informações do aplicativo botão a Aplicativo Guia de do Designer de projeto.
.gif "Observação") Observação: |
|---|
Version Information propriedades são armazenadas no arquivo de projeto (.vbp), que pode ser editado usando um editor de texto, sistema autônomo o bloco de notas. Assembly atributos são salvos no arquivo AssemblyInfo.vb file e podem ser editados no Editor de código. |
Propriedade File Description
O Visual Basic 6.0 App o objeto tem ambos FileDescription e Title Propriedades; FileDescription Determina o texto de descrição que aparece na Windows Explorer.
In Visual Basic 2008, não há nenhum FileDescription atributo. Em vez disso, a Title atributo determina o texto descritivo que aparece na Windows Explorer.
Propriedade HelpFile
The HelpFile propriedade no Visual Basic 6.0 especifica um arquivo de ajuda no nível do aplicativo.
In Visual Basic 2008Arquivos de ajuda são especificados para uma base de cada formulário usando um HelpProvider componente. Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
Propriedades de Versão
The Major, Minor, e Revision Propriedades no Visual Basic 6.0 são usadas para retornar um número de versão de três partes de um aplicativo.
In Visual Basic 2008, as informações de versão também incluem um Build propriedade e o número de versão de quatro partes completa podem ser recuperado usando um único Version propriedade. Para obter mais informações, consulte Numeração de versão para usuários do Visual Basic 6.0.
Propriedade Title
The Title propriedade das App objeto no Visual Basic 6.0 pode ser alterado por código; fazer isso determina o nome que aparece no Windows tarefa Gerente.
In Visual Basic 2008, o Title atributo é somente leitura. The Text propriedade do formulário principal do aplicativo determina o nome que é mostrado na tarefa Gerente.Você pode conjunto o Text propriedade programaticamente, mas o texto na BAR de título do formulário será alterado também.
Propriedade TaskVisible
No Visual Basic 6.0, a TaskVisible propriedade das App objeto determina se um aplicativo aparece na lista do Windows tarefa (Windows 9x) ou o tarefa Gerenciador de aplicativos guia (Windows 2000 ou posterior).A propriedade normalmente é usada para impedir um usuário de fechar um aplicativo que foi desenvolvido para ser executado como uma tarefa em segundo plano.Na maioria dos casos, a TaskVisible propriedade é usada com aplicativos que não exibem interfaces do usuário.
In Visual Basic 2008, não há nenhum equivalente para o TaskVisible propriedade; no entanto, você pode criar um serviço do Windows ou um aplicativo console que não aparecerão na lista de tarefas.
Propriedade PrevInstance
The PrevInstance propriedade no Visual Basic 6.0 determina se uma instância do aplicativo já está sendo executada. Normalmente você chama PrevInstance na inicialização do aplicativo e abortar o aplicativo se ela retorna true.
Não há nenhum equivalente direto para PrevInstance em Visual Basic 2008. Você controla se várias instâncias de um aplicativo são permitidas ou não, definindo a propriedade Multiple Instance na guia Application em Project Designer.Em time de execução, um NextInstanceStarted evento é disparado quando um usuário tenta iniciar outra instância do aplicativo. Você pode adicionar código a esse manipulador de eventos para ativar a primeira instância do aplicativo.
Diferenças adicionais
Há uma série de App Propriedades do objeto no Visual Basic 6.0 que se referem a componentes ActiveX, automação OLE e outras tecnologias que agora estão obsoleto e não são suportadas no Visual Basic 2008. Elas estão anotadas na tabela de equivalências de propriedades do objeto App, posteriormente no neste tópico.
Alterações no código para o objeto App
Os exemplos de código a seguir ilustram as diferenças nas técnicas de codificação entre o Visual Basic 6.0 e Visual Basic 2008 para alguns comum usa da App objeto.
Alterações no código para exibir número de versão do aplicativo
O exemplo a seguir demonstra como recuperar o número de versão do aplicativo e exibi-lo em um rótulo.
' Visual Basic 6.0
Label1.Caption = "Version: " & App.Major & "." & App.Minor & "." _
& App.Revision
' Visual Basic
Label1.Text = My.Application.Info.Version.ToString()
Alterações no código para determinar o caminho do aplicativo
O exemplo a seguir demonstra como exibir um arquivo de imagem que é armazenado na pasta do aplicativo, obtendo-se o caminho para o aplicativo em tempo de execução.
' 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")
Alterações no código para impedir que uma segunda instância de um aplicativo seja executada
O exemplo a seguir demonstra como implementar um aplicativo de instância única.
' 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
Propriedades equivalentes do Objeto App
A tabela a seguir lista todas as propriedades e métodos do Visual Basic 6.0 App objeto e seus Visual Basic 2008 equivalentes.
Visual Basic 6,0 |
Visual Basic 2008 Equivalente a |
|---|---|
Comments |
|
CompanyName |
|
EXEName |
|
FileDescription |
|
HelpFile |
Nova implementação.Use um HelpProvider componente. Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0. |
HInstance |
|
LegalCopyright |
|
LegalTrademarks |
|
LogEvent method |
|
LogMode LogPath |
Nova implementação.Para obter mais informações, consulte Registrando Informações de log do aplicativo. |
Major |
Propriedade My.Aplicativo.Informações.Versãoosion Observação:
O formato para números de versão é diferente no Visual Basic 2008.Para obter mais informações, consulte Numeração de versão para usuários do Visual Basic 6.0.
|
Minor |
Propriedade My.Aplicativo.Informações.Versãoosion Observação:
O formato para números de versão é diferente no Visual Basic 2008.Para obter mais informações, consulte Numeração de versão para usuários do Visual Basic 6.0.
|
NonModalAllowed |
Nova implementação.Esta é uma propriedade somente para leitura relacionada aos arquivos .dll ActiveX.O Common Language Runtime gerencia automaticamente esse comportamento. |
OleRequestPendingMsgText OleRequestPendingMsgTitle OleRequestPendingTimeout OleServerBusyMsgText OleServerBusyMsgTitle OleServerBusyRaiseError OleServerBusyTimeout |
Não há equivalente.Essas propriedades são relacionadas com a automação OLE, que não é suportada por Visual Basic 2008. |
Path |
|
PrevInstance |
Observação:
O IsSingleInstance propriedade é um Protected propriedade. Ela só pode ser definida no tempo de design em Project Designer, marcando ou desmarcando a caixa de seleção Multiple Instance.
|
ProductName |
|
RetainedProject |
Nova implementação.Visual Basic 2008 não consegue manter um projeto na memória. |
Revision |
Propriedade My.Aplicativo.Informações.Versãoosion Observação:
O formato para números de versão é diferente no Visual Basic 2008.Para obter mais informações, consulte Numeração de versão para usuários do Visual Basic 6.0.
|
StartLogging method |
Nova implementação.Para obter mais informações, consulte Registrando Informações de log do aplicativo. |
StartMode |
Não há equivalente.Esta propriedade está relacionada à criar componentes ActiveX, que não tem suporte no Visual Basic 2008. |
TaskVisible |
Nova implementação.Para criar um aplicativo que não aparece no Task Manager, crie um projeto Console Application ou um projeto Windows Service. |
ThreadID |
Nova implementação.Esta propriedade retornava a ID do thread em execução; o modelo de threading é significativamente diferente no Visual Basic 2008. |
Title |
|
UnattendedApp |
Nova implementação.Para aplicativos autônomos no Visual Basic 2008, crie um Aplicativo de consoleprojeto . |
Observações de Atualização
Quando um aplicativo é atualizado do Visual Basic 6.0, somente o Major e Minor propriedades são atualizadas; Visual Basic 2008 atribui novos valores para o Revision e Build Propriedades.
Consulte também
Conceitos
Suporte de Ajuda para Usuários do Visual Basic 6.0
Numeração de versão para usuários do Visual Basic 6.0