Comment : contrôler la disponibilité d'une variable

Article
09/12/2008

Mise à jour : novembre 2007

Vous pouvez contrôler la disponibilité d'une variable en spécifiant son niveau d'accès. Le niveau d'accès détermine quel code a l'autorisation de lire ou d'écrire dans la variable.

Les variables membres (définies au niveau du module et en dehors de toute procédure) autorisent par défaut un accès public, ce qui signifie que tout code peut les consulter et y accéder. Vous pouvez modifier cela en spécifiant un modificateur d'accès.
Les variables locales (définies à l'intérieur d'une procédure) ont un accès public nominativement, bien que seul le code situé dans leur procédure puisse y accéder. Vous ne pouvez pas modifier le niveau d'accès d'une variable locale, mais vous pouvez modifier celui de la procédure qui la contient.

Pour plus d'informations, consultez Niveaux d'accès dans Visual Basic.

Accès privé et public

Pour rendre une variable accessible uniquement à partir de son module, de sa classe ou de sa structure

Placez l'Dim, instruction (Visual Basic) pour la variable à l'intérieur du module, de la classe ou de la structure, mais en dehors de toute procédure.
Incluez le mot clé Private (Visual Basic) dans l'instruction Dim.

Vous pouvez lire ou écrire dans la variable à partir de tout emplacement dans le module, la classe ou la structure, mais pas depuis l'extérieur.

Pour rendre une variable accessible à partir de tout code qui peut le consulter

Pour une variable membre, placez l'instruction Dim pour la variable à l'intérieur d'un module, d'une classe ou d'une structure, mais en dehors de toute procédure.
Incluez le mot clé Public (Visual Basic) dans l'instruction Dim.

Vous pouvez lire ou écrire dans la variable à partir de tout code qui interagit avec votre assembly.

- ou -

Pour une variable locale, placez l'instruction Dim pour la variable à l'intérieur d'une procédure.
N'incluez pas le mot clé Public dans l'instruction Dim.

Vous pouvez lire ou écrire dans la variable à partir de tout emplacement dans la procédure, mais pas depuis l'extérieur.

Accès protégé et ami

Vous pouvez limiter le niveau d'accès d'une variable à sa classe et à toute classe dérivée, ou à son assembly. Vous pouvez spécifier également l'union de ces limitations, ce qui autorise l'accès à partir de code situé dans toute classe dérivée ou à tout autre emplacement dans le même assembly. Vous spécifiez cette union en combinant les mots clé Protected et Friend dans la même déclaration.

Pour rendre une variable accessible uniquement à partir de sa classe et de toute classe dérivée

Placez l'instruction Dim pour la variable à l'intérieur d'une classe, mais en dehors de toute procédure.
Incluez le mot clé Protected (Visual Basic) dans l'instruction Dim.

Vous pouvez lire ou écrire dans la variable à partir de tout emplacement dans la classe, ainsi que depuis toute classe dérivée d'elle, mais pas depuis l'extérieur d'une classe dans la chaîne de dérivation.

Pour rendre une variable accessible uniquement à partir du même assembly

Placez l'instruction Dim pour la variable à l'intérieur d'un module, d'une classe ou d'une la structure, mais en dehors de toute procédure.
Incluez le mot clé Friend (Visual Basic) dans l'instruction Dim.

Vous pouvez lire ou écrire dans la variable à partir de tout emplacement dans le module, la classe ou la structure, ainsi qu'à partir de tout code situé dans le même assembly, mais pas depuis l'extérieur de l'assembly.

Exemple

L'exemple suivant montre des déclarations de variables avec des niveaux d'accès Public, Protected, Friend, Protected Friend et Private. Notez que lorsque l'instruction Dim spécifie un niveau d'accès, il n'est pas nécessaire d'inclure le mot clé Dim.

Public Class classForEverybody
Protected Class classForMyHeirs
Friend stringForThisProject As String
Protected Friend stringForProjectAndHeirs As String
Private numberForMeOnly As Integer