Interface Statement (Visual Basic)

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Déclare le nom d'une interface et introduit les définitions des membres contenus dans l'interface.

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

TermeDéfinition
attributelistFacultatif. Consultez Liste d'attributs.
accessmodifierFacultatif. Il peut s'agir de l'une des valeurs suivantes :

- Public
- Protégé
- Friend
- Privé
- Protected Friend

Consultez Access Levels in Visual Basic.
ShadowsFacultatif. Consultez Shadows.
nameObligatoire. Nom de cette interface. Consultez Declared Element Names.
OfFacultatif. Indique qu'il s'agit d'une interface générique.
typelistObligatoire si vous utilisez le mot clé Of. Liste de paramètres de type pour cette interface. Éventuellement, chaque paramètre de type peut être déclaré variant à l'aide des modificateurs génériques In et Out. Consultez Liste de types.
InheritsFacultatif. Indique que cette interface hérite des attributs et des membres d'une autre ou d'autres interfaces. Consultez Inherits Statement.
interfacenamesRequis si vous utilisez l'instruction Inherits. Noms des interfaces d'où dérive cette interface.
modifiersFacultatif. Modificateurs appropriés pour le membre d'interface défini.
PropertyFacultatif. Définit une propriété qui est membre de l'interface.
FunctionFacultatif. Définit une procédure Function qui est membre de l'interface.
SubFacultatif. Définit une procédure Sub qui est membre de l'interface.
EventFacultatif. Définit un événement qui est membre de l'interface.
InterfaceFacultatif. Définit une interface qui est imbriquée dans cette interface. La définition de l'interface imbriquée doit se terminer par une instruction End Interface.
ClassFacultatif. Définit une classe qui est membre de l'interface. La définition de la classe membre doit se terminer par une instruction End Class.
StructureFacultatif. Définit une structure qui est membre de l'interface. La définition de la structure membre doit se terminer par une instruction End Structure.
membernameObligatoire pour chaque propriété, procédure, événement, interface, classe ou structure défini comme membre de l'interface. Nom du membre.
End InterfaceMet fin à la définition Interface.

Une interface définit un ensemble de membres, par exemple des propriétés et des procédures que les classes et les structures peuvent implémenter. L'interface définit uniquement les signatures des membres, mais pas leurs mécanismes internes.

Une classe ou une structure implémente l'interface en fournissant un code pour chaque membre défini par l'interface. Enfin, lorsque l'application crée une instance à partir de cette classe ou structure, un objet existe et s'exécute en mémoire. Pour plus d'informations, consultez Objects and Classes et Interfaces.

Vous pouvez utiliser Interface uniquement au niveau de l'espace de noms ou du module. Cela signifie que le contexte de déclaration pour une interface doit être un fichier source, un espace de noms, une classe, une structure, un module ou une interface, et ne peut pas être une procédure ou un bloc. Pour plus d'informations, consultez Declaration Contexts and Default Access Levels.

Les interfaces disposent par défaut d'un accès Friend. Vous pouvez régler leurs niveaux d'accès avec les modificateurs d'accès. Pour plus d'informations, consultez Access Levels in Visual Basic.

  • Imbrication des interfaces. Vous pouvez définir une interface dans une autre. L'interface externe est appelée interface conteneur, et l'interface interne est appelée interface imbriquée.

  • Déclaration de membre. Lorsque vous déclarez une propriété ou une procédure comme membre d'une interface, vous définissez uniquement la signature de cette propriété ou procédure. Cela inclut le type d'élément (propriété ou procédure), ses paramètres et types de paramètre et son type de retour. De ce fait, la définition du membre utilise une seule ligne de code, et les instructions de fin telles que End Function ou End Property ne sont pas valides dans une interface.

    En revanche, lorsque vous définissez une énumération ou une structure, ou encore une classe ou une interface imbriquée, il est nécessaire d'inclure leurs données membres.

  • Modificateurs de membre. Vous ne pouvez pas utiliser des modificateurs d'accès lors de la définition de membres de module, et vous ne pouvez pas spécifier Shared ou un modificateur de procédure sauf Overloads. Vous pouvez déclarer tout membre avec Shadows, et vous pouvez utiliser Default, ainsi que ReadOnly ou WriteOnly, lors de la définition d'une propriété.

  • Héritage. Si l'interface utilise Inherits Statement, vous pouvez spécifier une ou plusieurs interfaces de base. Vous pouvez hériter de deux interfaces même si chacune définit un membre avec le même nom. Dans ce cas, le code d'implémentation doit utiliser la qualification de nom pour spécifier le membre qu'il implémente.

    Une interface ne peut pas hériter d'une autre interface dont le niveau d'accès est plus restrictif. Par exemple, une interface Public ne peut pas hériter d'une interface Friend.

    Une interface ne peut pas hériter d'une interface qui y est imbriquée.

  • Implémentation. Lorsqu'une classe utilise l'instruction Implements pour implémenter cette interface, elle doit implémenter chaque membre défini dans l'interface. En outre, chaque signature dans le code d'implémentation doit correspondre exactement à la signature associée définie dans cette interface. Toutefois, le nom du membre dans le code d'implémentation ne doit pas correspondre au nom du membre défini dans l'interface.

    Lorsqu'une classe implémente une procédure, elle ne peut pas désigner la procédure comme Shared.

  • Default, propriété. Une interface peut spécifier au plus une propriété comme sa propriété par défaut, qui peut être référencée sans utiliser le nom de la propriété. Vous spécifiez cette propriété en la déclarant avec le modificateur Default.

    Cela signifie qu'une interface peut définir une propriété par défaut uniquement si elle n'en hérite d'aucune.

  • Niveau d'accès. Tous les membres d'interface possèdent implicitement un accès Public. Vous ne pouvez pas utiliser un modificateur d'accès lors de la définition d'un membre. Toutefois, une classe qui implémente l'interface peut déclarer un niveau d'accès pour chaque membre implémenté.

    Si vous assignez une instance de classe à une variable, le niveau d'accès de ses membres varie selon que le type de données de la variable est l'interface sous-jacente ou la classe d'implémentation. L'exemple suivant illustre ce comportement.

        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()
    

    Si vous accédez aux membres d'une classe par l'intermédiaire de varAsInterface, ils disposent tous d'un accès public. Toutefois, si vous accédez aux membres par l'intermédiaire de varAsClass, la procédure Sub doSomething dispose d'un accès privé.

  • Portée. Une interface est présente dans la portée dans l'ensemble de son espace de noms, sa classe, sa structure ou son module.

    La portée de chaque membre d'interface est l'interface entière.

  • Durée de vie. Une interface proprement dite n'a pas de durée de vie, ni ses membres. Lorsqu'une classe implémente une interface et qu'un objet est créé en tant qu'instance de cette classe, l'objet a une durée de vie dans l'application dans laquelle il s'exécute. Pour plus d'informations, consultez « Durée de vie » dans Class Statement.

L'exemple suivant utilise l'instruction Interface pour définir une interface nommée thisInterface, qui doit être implémentée avec une instruction Property et une instruction Function.

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

Notez que les instructions Property et Function n'introduisent pas de blocs se terminant par End Property et End Function dans l'interface. L'interface définit uniquement les signatures de ses membres. Les blocs Property et Function complets apparaissent dans une classe qui implémente thisInterface.

Interfaces
Class Statement
Module Statement
Structure Statement
Property Statement
Function Statement
Sub Statement
Types génériques Visual Basic
Variance dans les interfaces génériques
In
Out

Afficher: