How to: Responder a eventos de referências da Web (Visual Basic)

Artigo
08/04/2011

Os eventos de ambiente definidos no VSLangProj e VSLangProj80 são específicas para Visual C# e Visual Basic projetos. VSLangProjWebReferencesEventsé um novo tipo de Visual Studio 2005. Ele é disparado quando uma referência da Web é adicionada ou removida de um Visual Basic ou Visual C# o projeto, ou quando as propriedades de uma referência da Web são modificadas em um Visual Basic ou Visual C# project.

Este exemplo usa Visual Basic para conectar métodos de manipulação de eventos para um projeto específico usando o VSLangProjWebReferencesEvents propriedade.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Esses procedimentos foram desenvolvidos com o General Development Settings ativo. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Esses procedimentos foram desenvolvidos com o General Development Settings ativo. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Para manipular eventos relacionados às referências da Web usando o Visual Basic

Criar um Visual Studio projeto de suplemento no Visual Basic.
Sobre o projeto menu, clique em Add Reference, clique o .NET , selecione o primeiro VSLangProj e VSLangProj80 e clique em OK.
Adicionar Imports VSLangProj e Imports VSLangProj80 para a parte superior do arquivo Connect. vb.
Na classe Connect, inicializar uma variável para lidar com o VSLangProjWebReferencesEvents objeto.
```
Public Class Connect
    Implements IDTExtensibility2
    Dim _applicationObject As DTE2
    Dim _addInInstance As AddIn
    Public WithEvents webRefEvents As _
    VSLangProj80.VSLangProjWebReferencesEvents
```
Neste exemplo, a variável é chamada webRefEvents.

Outros objetos no modelo de automação referem-se a outros tipos de eventos que são específicos para o projeto. Por exemplo, ImportsEvents é disparado quando uma importação é adicionada ou removida de um Imports coleção. BuildManagerEventsaplica-se para eventos relacionados a assemblies temporários criados a partir de saídas de ferramentas personalizadas. Para obter mais informações sobre BuildManager de objeto, consulte Introdução ao objeto BuildManager. Para obter uma lista completa dos eventos que são específicos para tipos de projetos, consulte Objetos de evento (específicas para tipos de projetos). Para obter uma lista de eventos de automação gerais, consulte Objetos de evento de automação.

Adicione a seguinte chamada de método para o método OnConnection.

Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    WebReferenceEventsSample(_applicationObject)
End Sub

Adicione a declaração de método de WebReferenceEventsSample diretamente abaixo o método OnConnection.
```
Sub WebReferenceEventsSample(ByVal dte As DTE2)

End Sub
```
Adicione as seguintes declarações na parte superior do método WebReferenceEventsSample.
```
Dim soln As Solution2 = CType(_applicationObject.Solution, Solution2)
Dim proj As Project
Dim vsproj As VSProject2
Dim webServiceRef As String
proj = soln.Projects.Item(1)
```
A declaração proj = soln.Projects.Item(1) requer que um projeto é aberto no Visual Studio o ambiente de desenvolvimento integrado (IDE), quando você executar esse exemplo. Em particular, o projeto deve ser um Visual Basic ou Visual C# de projeto porque a VSLangProjWebReferencesEvents o objeto é específico para esses tipos de projeto.
Converter o projeto para um VSProject2 o objeto, adicionando o seguinte código para o método WebReferenceEventsSample.
```
' Cast the project to a VSProject2.
vsproj = CType(proj.Object, VSProject2)
```
Também no método WebReferenceEventsSample, recupere os objetos de eventos do modelo de automação.
```
webRefEvents = vsproj.Events2.VSLangProjWebReferencesEvents
```

Conecte os manipuladores de eventos.

AddHandler webRefEvents.OnAfterWebReferenceAdded, _
 AddressOf WebReferenceAdded
AddHandler webRefEvents.OnBeforeWebReferenceRemoved, _
 AddressOf WebReferenceRemoved
AddHandler webRefEvents.OnWebReferenceChanged, _
 AddressOf WebReferenceChanged

Adicione uma referência da Web ao projeto.

' Create a Web references folder.
MsgBox("Creating a Web references folder.", MsgBoxStyle.Information)
vsproj.CreateWebReferencesFolder()
' Add a Web reference to the folder.
' Replace the "<web reference>" with an actual Web service URL.
MsgBox("Adding a Web reference.", MsgBoxStyle.Information)
webServiceRef = "<web reference>"
vsproj.AddWebReference(webServiceRef)

Para adicionar programaticamente uma referência de serviço da Web ao projeto, você deve substituir o texto de espaço reservado, <web reference>, no código com a URL de um Web service.

Essa etapa faz com que o OnAfterWebReferenceAdded evento seja acionado quando você executar este add-in.

Adicione os procedimentos para cada evento relacionados ao objeto de evento.

Sub WebReferenceRemoved(ByVal removedRef As Object)
    MsgBox("A Web reference was removed.")
End Sub
Sub WebReferenceChanged(ByVal changedRef As Object)
    MsgBox("A Web reference was changed.")
End Sub
Sub WebReferenceAdded(ByVal addedRef As Object)
    MsgBox("A Web reference was added.")
End Sub

Finalmente, para evitar Visual Studio da redução do seu sistema, continuando a monitorar eventos de janela depois de fechar o add-in, desativar tratamento de evento. Em Visual Basic, isso é feito definindo-se o manipulador de eventos para Nothing.
```
Public Sub OnDisconnection(ByVal RemoveMode As_
 Extensibility.ext_DisconnectMode, ByRef custom As System.Array)_
 Implements Extensibility.IDTExtensibility2.OnDisconnection
    webRefEvents = Nothing
End Sub
```
O código completo está listado na seção exemplo deste tópico.
Para criar o suplemento, clique em Build Solution sobre o Build menu.
Abrir um Visual C# ou Visual Basic projeto na Visual Studio o ambiente de desenvolvimento integrado (IDE).
No Ferramentas menu, clique em Gerenciador de suplementose selecione o add-in da Gerenciador de suplementos caixa de diálogo. Clique em OK para executar seu suplemento.

Para testar o tratamento de evento VSLangProjWebReferencesEvents

O OnAfterWebReferenceAdded evento é acionado uma vez ao executar o suplemento, porque o exemplo adiciona uma referência a um serviço da Web programaticamente.
Para testar o OnWebReferenceChanged evento:
- Expanda o Referências da Web a pasta em Solution Explorer.
- Selecione o serviço da Web e clique sobre ela.
- Selecione Propriedades no menu drop-down.
- No Propriedades janela, alterar o comportamento de URL de selecionando dinâmico para estático por estático da Comportamento URL caixa de combinação.
Para testar o OnBeforeWebReferenceRemoved evento:
- Selecione o serviço da Web e clique sobre ela.
- Selecione Excluir no menu drop-down.

Exemplo

Imports System
Imports Microsoft.VisualStudio.CommandBars
Imports Extensibility
Imports EnvDTE
Imports EnvDTE80
Imports VSLangProj
Imports VSLangProj2
Imports VSLangProj80

Public Class Connect
    Implements IDTExtensibility2
    Dim _applicationObject As DTE2
    Dim _addInInstance As AddIn
    Public WithEvents webRefEvents As _
    VSLangProj80.VSLangProjWebReferencesEvents
    Public Sub New()
    End Sub
    Public Sub OnConnection(ByVal application As Object, _
     ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object _
    , ByRef custom As Array) Implements IDTExtensibility2.OnConnection
        _applicationObject = CType(application, DTE2)
        _addInInstance = CType(addInInst, AddIn)
        WebReferenceEventsSample(_applicationObject)
    End Sub
    Sub WebReferenceEventsSample(ByVal dte As DTE2)
        Try
            Dim soln As Solution2 = CType(_applicationObject.Solution _
            , Solution2)
            Dim proj As Project
            Dim vsproj As VSProject2
            Dim webServiceRef As String
            proj = soln.Projects.Item(1)
            ' Cast the project to a VSProject2.
            vsproj = CType(proj.Object, VSProject2)
            webRefEvents = vsproj.Events2.VSLangProjWebReferencesEvents
            AddHandler webRefEvents.OnAfterWebReferenceAdded, _
            AddressOf WebReferenceAdded
            AddHandler webRefEvents.OnBeforeWebReferenceRemoved, _
            AddressOf WebReferenceRemoved
            AddHandler webRefEvents.OnWebReferenceChanged, _
            AddressOf WebReferenceChanged
            ' Create a Web references folder.
            MsgBox("Creating a Web references folder." _
            , MsgBoxStyle.Information)
            vsproj.CreateWebReferencesFolder()
            ' Add a Web reference to the folder.
            ' Replace the place holder <web reference> with
            ' a Web service URL.
            MsgBox("Adding a Web reference.", MsgBoxStyle.Information)
            webServiceRef = "<web reference>"
            vsproj.AddWebReference(webServiceRef)
        Catch ex As System.Exception
            MsgBox(ex.ToString)
        End Try
    End Sub
    Sub WebReferenceRemoved(ByVal removedRef As Object)
        MsgBox("A Web reference was removed.")
    End Sub
    Sub WebReferenceChanged(ByVal changedRef As Object)
        MsgBox("A Web reference was changed.")
    End Sub
    Sub WebReferenceAdded(ByVal addedRef As Object)
        MsgBox("A Web reference was added.")
    End Sub
    Public Sub OnDisconnection(ByVal disconnectMode As _
    ext_DisconnectMode, ByRef custom As Array) Implements _
    IDTExtensibility2.OnDisconnection
        ' Turns off Web reference event handling when the 
        ' add-in shuts down.
        webRefEvents = Nothing
    End Sub
    Public Sub OnAddInsUpdate(ByRef custom As Array) _
    Implements IDTExtensibility2.OnAddInsUpdate
    End Sub
    Public Sub OnStartupComplete(ByRef custom As Array) _
    Implements IDTExtensibility2.OnStartupComplete
    End Sub
    Public Sub OnBeginShutdown(ByRef custom As Array) _
    Implements IDTExtensibility2.OnBeginShutdown
    End Sub
End Class

Compilando o código

Para compilar esse código, crie um novo Visual Studio projeto de suplemento no Visual Basic e substitua o código da classe de conectar-se com o código de exemplo. Para obter informações sobre como executar um suplemento, consulte Como: controle de Adicionar-</c0>.

Consulte também

Tarefas

How to: Responder a eventos de referências da Web (Visual C#)

Outros recursos

Respondendo a eventos de automação

Respondendo a eventos (Visual Basic e projetos do Visual C#)

Partilhar via