Instrução (Visual Basic) de interface.

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

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 Objetos e Classes em Visual Basic e Interfaces (Visual Basic).

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 Níveis de acesso padrão (Visual Basic) e os contextos de declaração.

Interfaces padrão para acesso Amigo (Visual Basic).Você pode ajustar os seus 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 um procedimento como um membro de uma interface, você está apenas definindo a assinatura de propriedade ou de 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 membros. Não é possível usar qualquer modificadores de acesso ao definir os membros do módulo, nem pode especificar Compartilhado (Visual Basic) ou qualquer modificador de procedimento exceto Sobrecargas (Visual Basic).Você pode declarar qualquer membro com Sombras (Visual Basic), e você pode usar Padrão (Visual Basic) quando definir uma propriedade, assim como ReadOnly (Visual Basic) ou WriteOnly (Visual Basic).

• Herança. Se a interface usa o Herda a instrução, 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 Cláusula implements (Visual Basic) instrução para implementar essa interface, ele deve implementar cada 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, que podem ser referenciados sem usar o nome da propriedade.Você especifica tal propriedade declarando-a com o modificador Padrão (Visual Basic).

  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 implicitamente têm Público (Visual Basic) acesso.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 particular.

• 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 de classe (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

Referência

Declaração de classe (Visual Basic)

Declaração do módulo

Declaração Structure

Instrução Property

Instrução de função (Visual Basic)

Instrução Sub (Visual Basic)

Em (modificador genérico) (Visual Basic)

Check-out (modificador genérico) (Visual Basic)

Conceitos

Tipos genéricos em Visual Basic (Visual Basic)

Variação em Interfaces genéricas (C# e Visual Basic)

Outros recursos

Interfaces (Visual Basic)