Encapsuler un champ (refactorisation)Encapsulate a field refactoring

Cette refactorisation s’applique à :This refactoring applies to:

  • C#C#

  • Visual BasicVisual Basic

Quoi : vous permet de transformer un champ en une propriété et de mettre à jour toutes les utilisations de ce champ afin d’utiliser cette nouvelle propriété.What: Lets you turn a field into a property, and update all usages of that field to use the newly created property.

Quand : vous souhaitez déplacer un champ vers une propriété et mettre à jour toutes les références à ce champ.When: You want to move a field into a property, and update all references to that field.

Pourquoi : vous voulez donner à d’autres classes l’accès à un champ, mais ne souhaitez pas que ces classes dispose d’un accès direct.Why: You want to give other classes access to a field, but don't want those classes to have direct access. En encapsulant le champ dans une propriété, vous pouvez écrire un code pour vérifier la valeur assignée, par exemple.By wrapping the field in a property, you could write code to verify the value being assigned, for example.

ProcédureHow-to

  1. Mettez en surbrillance ou placez le curseur de texte dans le nom du type à encapsuler :Highlight or place the text cursor inside the name of the field to encapsulate:

    • C# :C#:

      Code mis en surbrillance (C#)

    • Visual Basic :Visual Basic:

      Code mis en surbrillance (Visual Basic)

  2. Effectuez ensuite l'une des opérations suivantes :Next, do one of the following:

    • ClavierKeyboard
      • Appuyez sur Ctrl+R, puis Ctrl+E.Press Ctrl+R, then Ctrl+E. (Notez que le raccourci clavier peut varier en fonction du profil que vous avez sélectionné.)(Note that your keyboard shortcut may be different based on which profile you've selected.)
      • Appuyez sur Ctrl+.Press Ctrl+. pour afficher le menu Actions rapides et refactorisations, puis sélectionnez l’entrée Encapsuler le champ dans la fenêtre contextuelle d’aperçu.to trigger the Quick Actions and Refactorings menu and select either Encapsulate field entry from the Preview window popup.
    • SourisMouse
      • Sélectionnez Modifier > Refactoriser > Encapsuler le champ.Select Edit > Refactor > Encapsulate Field.
      • Cliquez avec le bouton droit sur le code et choisissez le menu Actions rapides et refactorisations, puis sélectionnez l’entrée Encapsuler le champ dans la fenêtre contextuelle d’aperçu.Right-click the code, select the Quick Actions and Refactorings menu and select either Encapsulate field entry from the Preview window popup.
    SélectionSelection DescriptionDescription
    Encapsuler le champ (et utiliser la propriété)Encapsulate field (and use property) Encapsule le champ avec une propriété et met à jour toutes les utilisations du champ afin d’utiliser la propriété généréeEncapsulates the field with a property, and updates all usages of the field to use the generated property
    Encapsuler le champ (mais utiliser toujours le champ)Encapsulate field (but still use field) Encapsule le champ avec une propriété, mais conserve intactes toutes les utilisations de ce champEncapsulates the field with a property, but leaves all usages of the field untouched

    La propriété est créée et les références au champ sont mises à jour, le cas échéant.The property is created and references to the field are updated, if selected.

    Tip

    Utilisez le lien Aperçu des modifications dans la fenêtre contextuelle pour prévisualiser le résultat avant de le valider.Use the Preview changes link in the popup window to see what the result will be before committing to it.

    • C# :C#:

      Résultat de l’action Encapsuler une propriété (C#)

    • Visual Basic :Visual Basic:

      Résultat de l’action Encapsuler une propriété (Visual Basic)

Voir aussiSee also