With, instruction

---

Description

Exécute une série d'instructions sur un objet unique.

Syntaxe

With object
    statements
End With

La syntaxe de l'instruction With comprend les éléments suivants :

Élément	Description
object	Nom d'un objet ou d'une fonction qui renvoie un objet.
statements	Requis. Une ou plusieurs instructions à appliquer sur un objet.

Notes

L'instruction With vous permet d'effectuer une série d'instructions sur un objet spécifique sans qu'il ne soit nécessaire de qualifier à nouveau le nom de l'objet. Pour modifier le nombre des propriétés relatives à un objet unique, par exemple, placez les instructions d'affection de propriété dans la structure de contrôle With. Celle-ci fait référence à l'objet une seule fois au lieu de faire référence à l'objet à chaque affectation. L'exemple suivant montre comment l'instruction With est utilisée pour affecter des valeurs à plusieurs propriétés d'un même objet.

With MyLabel
  .Height = 2000
  .Width = 2000
  .Caption = "Ceci est MonÉtiquette"
End With

La manipulation des propriétés est un aspect important de la fonctionnalité With mais elle n'en représente pas la seule utilité. Tout code légal peut être utilisé dans le bloc With.

Remarque  Lorsque le bloc With est saisi, l'objet ne peut pas être modifié. Par conséquent, vous ne pouvez pas utiliser une seule instruction With pour affecter différents objets.

Il est possible d'imbriquer des instructions With en plaçant un bloc With à l'intérieur d'un autre. Cependant, les membres des blocs With externes étant cachés au sein des blocs With internes, il est nécessaire de fournir une référence à l'objet complète dans un bloc With interne à tout membre d'un objet figurant dans un bloc With externe.

Important  Ne passez pas dans ou hors des blocs With. Si les instructions d'un bloc With sont exécutées, sauf l'instruction With ou l'instructionEnd With, vous risquez de constater des erreurs ou un comportement différent.

---