Get

Syntaxe

Paramètres

Description

Ce mot réservé permet de déclarer une procédure de propriété Get utilisée pour récupérer la valeur d'une propriété.

Remarques

• Chaque propriété doit avoir une procédure de propriété Get, sauf si la propriété est marquée WriteOnly. La procédure Get est utilisée pour renvoyer la valeur actuelle de la propriété.
• Le Visual Basic .NET appelle automatiquement la procédure Get d'une propriété lorsqu'une expression demande la valeur de la propriété.
• Le corps de la déclaration de propriété ne peut contenir que les procédures Get et Set de la propriété entre l'instruction Property et l'instruction End Property. Il ne peut pas entreposer autre chose que ces procédures. En particulier, il ne peut pas entreposer la valeur actuelle de la propriété. Vous devez entreposer cette valeur en dehors de la propriété, car si vous l'entreposez dans l'une des procédures de propriété, l'autre procédure de propriété ne peut pas y accéder. L'approche habituelle consiste à stocker la valeur dans une variable Private déclarée au même niveau que la propriété. Vous devez définir une procédure Get à l'intérieur de la propriété à laquelle elle s'applique.
• La procédure Get utilise par défaut le niveau d'accès de sa propriété conteneur, sauf si vous utilisez accessmodifier dans l'instruction Get.
• Niveaux d'accès mixtes : Si vous définissez une propriété en lecture-écriture, vous pouvez éventuellement spécifier un niveau d'accès différent pour la procédure Get ou Set, mais pas les deux. Si vous procédez ainsi, le niveau d'accès de la procédure doit être plus restrictif que le niveau d'accès de la propriété. Par exemple, si la propriété est déclarée Friend, vous pouvez déclarer la procédure Get Private, mais pas Public. Si vous définissez une propriété ReadOnly, la procédure Get représente la propriété entière. Vous ne pouvez pas déclarer un niveau d'accès différent pour Get, car cela définirait deux niveaux d'accès pour la propriété.
• Type de retour : L'instruction de propriété peut déclarer le type de données de la valeur qu'elle renvoie. La procédure Get renvoie automatiquement ce type de données. Vous pouvez spécifier n'importe quel type de données ou le nom d'une énumération, d'une structure, d'une classe ou d'une interface. Si l'instruction Property ne spécifie pas le type de retour, la procédure renvoie Object.
• De retour d'une procédure : Lorsque la procédure Get revient au code appelant, l'exécution se poursuit dans l'instruction ayant demandé la valeur de la propriété.
• Les procédures d'obtention de propriété peuvent renvoyer une valeur à l'aide de l'instruction Return ou en attribuant la valeur de retour au nom de la propriété.
• Les instructions Exit Property et Return provoquent une sortie immédiate d'une procédure de propriété. N'importe quel nombre d'instructions Exit Property et Return peuvent apparaître n'importe où dans la procédure, et vous pouvez mélanger les instructions Exit Property et Return.
• Valeur de retour  Pour renvoyer une valeur à partir d'une procédure Get, vous pouvez soit affecter la valeur au nom de la propriété, soit l'inclure dans une instruction Return. L'instruction Return affecte simultanément la valeur de retour de la procédure Get et quitte la procédure.
• Si vous utilisez Exit Property sans affecter de valeur au nom de la propriété, la procédure Get renvoie la valeur par défaut pour le type de données de la propriété.
• L'exemple suivant illustre deux manières dont la propriété en lecture seulement quoteForTheDay peut renvoyer la valeur contenue dans la variable privée quoteValue.