Instrução interface (Visual Basic)

Declara o nome de uma interface e apresenta as definições dos membros que a interface compreende.

Sintaxe

[ <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

Prazo	Definição
`attributelist`	Opcional. Consulte a Lista de Atributos.
`accessmodifier`	Opcional. Pode ser um dos seguintes: - Público - Protegido - Amigo - Privado - Amigo Protegido - Proteção Privada Consulte Níveis de acesso no Visual Basic.
`Shadows`	Opcional. Veja Sombras.
`name`	Obrigatório Nome dessa interface. Consulte nomes de elementos declarados.
`Of`	Opcional. Especifica que essa é uma interface genérica.
`typelist`	Obrigatório se você usar a palavra-chave De . Lista de parâmetros de tipo para essa interface. Opcionalmente, cada parâmetro de tipo pode ser declarado variante usando `In` e `Out` modificadores genéricos. Confira Lista de tipos.
`Inherits`	Opcional. Indica que essa interface herda os atributos e os membros de outra interface ou interfaces. Consulte a instrução Inherits.
`interfacenames`	Necessário se você usar a `Inherits` instrução. Os nomes das interfaces das quais essa interface deriva.
`modifiers`	Opcional. Modificadores apropriados para o membro da interface que está sendo definido.
`Property`	Opcional. Define uma propriedade que é um membro da interface.
`Function`	Opcional. Define um `Function` procedimento que é um membro da interface.
`Sub`	Opcional. Define um `Sub` procedimento que é um membro da interface.
`Event`	Opcional. Define um evento que é um membro da interface.
`Interface`	Opcional. Define uma interface aninhada nessa interface. A definição de interface aninhada deve terminar com uma instrução `End Interface` .
`Class`	Opcional. Define uma classe que é um membro da interface. A definição da classe membro deve terminar com uma instrução `End Class` .
`Structure`	Opcional. Define uma estrutura que é um membro da interface. A definição da estrutura de membro deve terminar com uma instrução `End Structure` .
`membername`	Necessário para cada propriedade, procedimento, evento, interface, classe ou estrutura definida como um membro da interface. O nome do membro.
`End Interface`	Encerra a `Interface` definição.

Observações

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

Uma classe ou estrutura implementa a interface fornecendo código para cada membro definido pela interface. Por fim, quando o aplicativo cria uma instância dessa classe ou estrutura, um objeto existe e é executado na memória. Para obter mais informações, consulte Objetos e Classes e Interfaces.

Você só pode usar Interface no namespace ou no nível do módulo. Isso significa que o contexto de declaração de uma interface deve ser um arquivo de origem, namespace, classe, estrutura, módulo ou interface e não pode ser um procedimento ou bloco. Para obter mais informações, consulte contextos de declaração e níveis de acesso padrão.

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

Regras

Interfaces de aninhamento. Você pode definir uma interface dentro de outra. A interface externa é chamada de interface independente e a interface interna é chamada de interface aninhada.
Declaração de Membro. Quando você declara uma propriedade ou procedimento como membro de uma interface, você está definindo apenas a assinatura dessa propriedade ou procedimento. Isso inclui o tipo de elemento (propriedade ou procedimento), seus parâmetros e tipos de parâmetro e seu tipo de retorno. Por isso, a definição de membro usa apenas uma linha de código e instruções de encerramento, como End Function ou End Property não são válidas em uma 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 modificadores de acesso ao definir membros do módulo, nem pode especificar Compartilhado ou qualquer modificador de procedimento, exceto Sobrecargas. Você pode declarar qualquer membro com Sombras e usar o Padrão ao definir uma propriedade, bem como ReadOnly ou WriteOnly.
Herança. Se a interface usar a Instrução Inherits, você poderá especificar uma ou mais interfaces base. Você pode herdar de duas interfaces mesmo que elas definam um membro com o mesmo nome. Se você fizer isso, o código de implementação deverá usar a qualificação de nome para especificar qual membro ele está implementando.

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

Uma interface não pode herdar de uma interface aninhada dentro dela.
Implementação. Quando uma classe usa a instrução Implements para implementar essa interface, ela deve implementar todos os membros definidos dentro da interface. Além disso, cada assinatura no código de implementação deve corresponder exatamente à assinatura correspondente definida nessa interface. No entanto, o nome do membro no código de implementação não precisa corresponder ao nome do membro, conforme definido na interface.

Quando uma classe está implementando um procedimento, ela não pode designar o procedimento como Shared.
Propriedade Padrão. Uma interface pode especificar no máximo uma propriedade como sua propriedade padrão, que pode ser referenciada sem usar o nome da propriedade. Especifique essa propriedade declarando-a com o modificador Padrão .

Observe que isso significa que uma interface só pode definir uma propriedade padrão se ela não herdar nenhuma.

Comportamento

Nível de acesso. Todos os membros da interface têm acesso público implicitamente. Você não pode usar nenhum modificador de acesso ao definir um membro. No entanto, uma classe que implementa a interface pode declarar um nível de acesso para cada membro implementado.

Se você atribuir uma instância de classe a uma variável, o nível de acesso de seus membros poderá depender se o tipo de dados da variável é a interface subjacente ou a classe de implementação. O exemplo a seguir ilustra essa situação.
```
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 os membros da classe por meio varAsInterface, todos eles terão acesso público. No entanto, se você acessar membros por meio varAsClass, o Sub procedimento doSomething terá acesso privado.
Escopo. Uma interface está no escopo em todo o namespace, classe, estrutura ou módulo.

O escopo de cada membro de interface é toda a interface.
Vida. Uma interface não tem um tempo de vida, nem seus membros. Quando uma classe implementa uma interface e um objeto é criado como uma instância dessa classe, o objeto tem um tempo de vida dentro do aplicativo no qual está em execução. Para obter mais informações, consulte "Tempo de vida" na Instrução de Classe.

Exemplo

O exemplo a seguir usa a Interface instrução para definir uma interface nomeada thisInterface, que deve ser implementada com uma Property instrução e uma Function instrução.

Public Interface thisInterface
    Property ThisProp(ByVal thisStr As String) As Char
    Function ThisFunc(ByVal thisInt As Integer) As Integer
End Interface

Observe que as instruções e as Property instruções Function não introduzem blocos que terminam com End Property e End Function dentro da interface. A interface define apenas as assinaturas de seus membros. Os blocos e Function completos PropertythisInterfaceaparecem em uma classe que implementa.

Consulte também

Comentários

Esta página foi útil?

Last updated on 2025-07-31