Declaração Interface (Visual Basic)

Declara o nome de uma interface e apresenta as definições dos membros dos quais a interface se constitui.

[ <attributelist> ] [ accessmodifier ] [ Shadows ] _
Interface name [ ( Of typelist ) ]
    [ Inherits interfacenames ]
    [ [ modifiers ] Property membername ]
    [ [ modifiers ] Function membername ]
    [ [ modifiers ] Sub membername ]
    [ [ modifiers ] Event membername ]
    [ [ modifiers ] Interface membername ]
    [ [ modifiers ] Class membername ]
    [ [ modifiers ] Structure membername ]
End Interface

Partes

  • attributelist
    Opcional.Veja Lista de Atributos.

  • accessmodifier
    Opcional.Pode ser um dos seguintes:

    SeeNíveis de acesso em Visual Basic.

  • Shadows
    Opcional.Acesse Shadows.

  • name
    Obrigatório.Nome desta interface.SeeNomes de Elementos Declarados.

  • Of
    Opcional.Especifica que esta é uma interface genérica.

  • typelist
    Exigido se você usar a palavra-chave Of.Lista de parâmetros de tipo para esta interface.Consulte Type List.

  • Inherits
    Opcional.Indica que esta interface herda os atributos e membros de outra(s) interface(s).SeeDeclaração Inherits.

  • interfacenames
    Necessário se você usar a declaração Inherits.Os nomes das interfaces a partir das quais essa interface deriva.

  • modifiers
    Opcional.Modificadores apropriados para o membro de interface sendo definido.

  • Property
    Opcional.Define a propriedade que é um membro da interface.

  • Function
    Opcional.Define um procedimento Function que é um membro da interface.

  • Sub
    Opcional.Define um procedimento Sub que é um membro da interface.

  • Event
    Opcional.Define um evento que é um membro da interface.

  • Interface
    Opcional.Define uma interface que é um aninhamento dentro desta interface.A definição aninhada de interface deve terminar com uma declaração End Interface.

  • Class
    Opcional.Define uma classe que é um membro da interface.A definição de classe de membro deve terminar com uma declaração End Class.

  • Structure
    Opcional.Define uma estrutura que é membro da interface.A definição membro de estrutura deve terminar com uma declaração End Structure.

  • membername
    Necessário para cada propriedade, procedimento, evento, interface, classe ou estrutura definidos como um membro da interface.O nome do membro.

  • End Interface
    Finaliza a definição Interface.

Comentários

Uma interface define um conjunto de membros, como propriedades ou procedimentos, que classes e estruturas podem implementar.A interface define apenas as assinaturas dos membros e não seu funconamento interno.

Uma classe ou estrutura implementa a interface fornecendo código para todo membro definido pela interface.Finalmente, quando o aplicativo cria um instância a partir daquela classe ou estrutura, um objeto existe e executa em memória.Para obter mais informações, consulte Programação orientada a objetos no Visual Basic e Interfaces em Visual Basic.

Para comparação de interfaces e classes, veja Visão geral de interfaces.

Você pode usar Interface somente em nível de namespace ou módulo.Isto significa que o contexto de declaração para uma interface deve ser um arquivo-fonte, namespace, estrutura, módulo, interface e não um procedimento ou bloco.Para obter mais informações, consulte Declaração de contextos e níveis de acesso padrão.

Interfaces padrão para acesso Amigo (Visual Basic).Você pode ajustar os níveis de acesso com os modificadores de acesso.Para obter mais informações, consulte Níveis de acesso em Visual Basic.

Regras

  • Interfaces de Aninhamento. Você pode definir uma interface dentro de outra.A interface mais externa é chamada a interface continente, e a interface mais interna é chamada uma interface aninhada.

  • Declaração de Membro. Quando você declara uma propriedade ou procedimento como um membro de uma interface, você está definindo apenas a assinatura daquela propriedade ou procedimento.Isto inclui o tipo de elemento (propriedade ou procedimento), seus parâmetros e tipos de parâmetro, e seu tipo de retorno.Por causa disso, a definição de membro usa apenas uma linha do código, e declarações de finalização como End Function ou End Property não são válidas numa interface.

    Por outro lado, quando você define uma enumeração ou estrutura, ou uma classe ou interface aninhada, é necessário incluir seus membros de dados.

  • Modificadores de Membro. Você não pode usar nenhum modificador de acesso quando definir membros de módulo, nem especificar Compartilhamento (Visual Basic) ou qualquer modificador de procedimento exceto Sobrecargas.Você pode declarar qualquer membro com Sombras, e você pode usar Padrão (Visual Basic) quando definir uma propriedade, assim como ReadOnly (Visual Basic) ou Somente-leitura.

  • Herança Se a interface usa o Declaração Inherits, você pode especificar uma ou mais interfaces de base.Você pode herdar de duas interfaces mesmo que cada uma delas defina um membro com o mesmo nome.Se fizer dessa forma, o código de implementação deve usar a mesma qualificação de nome para especificar que membro está sendo implementado.

    Uma interface não pode herdar de outra interface com um nível de acesso mais restrito.Por exemplo, uma interface Public não pode herdar de uma interface Friend.

    Uma interface não pode herdar de uma interface aninhada nela.

  • Implementação Quando uma classe usa a declaração Implements (Visual Basic) para implementar esta interface, ele deve implementar todo membro definido dentro da interface.Além disso, cada assinatura no código de implementação deve coincidir exatamente com a assinatura correpondente definida nesta interface.Entretanto, o nome do membro no código de implementação não precisa coincidir com o nome do membro definido na interface.

    Quando uma classe está implementando um procedimento, ela não pode designá-lo como Shared.

  • Propriedade Padrão Uma interface pode especificar no máximo uma propriedade como sua propriedade padrão, à qual pode se referir usando o nome da propriedade.Você especifica tal propriedade declarando-a com o modificador Padrão (Visual Basic).Para obter mais informações, consulte Propriedades Padrão.

    Observe que isso significa que um interface pode definir uma propriedade padrão apenas se ela não herda nada.

Comportamento

  • Nível de Acesso Todos os membros de interface possuem implicitamente acesso Público (Visual Basic).Você não pode usar nenhum modificador de acesso quando definir um membro.Entretanto, a classe que implementa a interface pode declarar um nível de acesso para cada membro implementado.

    Se você designar uma instância de classe a uma variável, o nível de acesso a seus membros pode depender de o tipo de dados da variável ser a interface subjacente ou a classe implementadora.O exemplo a seguir ilustra isto:

    Public Interface IDemo
        Sub doSomething()
    End Interface
    Public Class implementIDemo
        Implements IDemo
        Private Sub doSomething() Implements IDemo.doSomething
        End Sub
    End Class
    Dim varAsInterface As IDemo = New implementIDemo()
    Dim varAsClass As implementIDemo = New implementIDemo()
    

    Se você acessar membros de classe através de varAsInterface, todos eles possuem acesso público.No entanto, se você acessar membros por meio de varAsClass, o Sub procedimento doSomething tem acesso privado.

  • Escopo. Uma interface está em escopo por todo o seu namespace, classe, estrutura ou módulo.

    O escopo de todo membro de interface é a interface inteira.

  • Tempo de vida. Uma interface não possui um tempo de vida por ela mesma, nem seus membros.Quando uma classe implementa uma interface e um objeto é criado como uma instância daquela classe, o objeto possui um tempo de vida dentro do aplicativo no qual ele esa sendo executado.Para mais informações, consulte "Tempo de Vida" em Declaração Class (Visual Basic).

Exemplo

O exemplo a seguir usa a declaração Interface para definir uma interface denominada thisInterface, a qual deve ser implementada com uma declaração Property e uma Function.

Public Interface thisInterface
    Property thisProp(ByVal thisStr As String) As Char
    Function thisFunc(ByVal thisInt As Integer) As Integer
End Interface

Note que as declarações Property e Function não apresenta blocos terminando em End Property e End Function dentro da interface.A interface define apenas assinaturas dos seus membros.Os blocos inteiros Property e Function aparecem numa classe que implementa thisInterface.

Consulte também

Conceitos

Tipos genéricos no Visual Basic

Referência

Declaração Class (Visual Basic)

Declaração de Módulo

Instrução Structure

Propriedade declaração

Instrução Function (Visual Basic)

Sub-rotina demonstrativo (Visual Basic)

Outros recursos

Interfaces em Visual Basic