Guide pratique pour remplacer des méthodes de traitement des entrées

Ces exemples montrent comment remplacer les méthodes de traitement d’entrée au sein d’une applet de commande. Ces méthodes sont utilisées pour effectuer les opérations suivantes :

• La méthode System. Management. Automation. applet de commande. BeginProcessing est utilisée pour effectuer des opérations de démarrage à usage unique qui sont valides pour tous les objets traités par l’applet de commande. le runtime Windows PowerShell appelle cette méthode une seule fois.

• La méthode System. Management. Automation. applet de commande. ProcessRecord est utilisée pour traiter les objets passés à l’applet de commande. le runtime Windows PowerShell appelle cette méthode pour chaque objet passé à l’applet de commande.

• La méthode System. Management. Automation. applet de commande. EndProcessing est utilisée pour effectuer des opérations de validation unique. le runtime Windows PowerShell appelle cette méthode une seule fois.

Pour substituer la méthode BeginProcessing

• Déclarez une substitution protégée de la méthode System. Management. Automation. applet de commande. BeginProcessing.

La classe suivante affiche un exemple de message. Pour utiliser cette classe, modifiez le verbe et le nom dans l’attribut de l’applet de commande, modifiez le nom de la classe pour refléter le nouveau verbe et le nom, puis ajoutez la fonctionnalité dont vous avez besoin à la substitution de la méthode System. Management. Automation. applet de commande. BeginProcessing.

[Cmdlet(VerbsDiagnostic.Test, "BeginProcessingClass")]
public class TestBeginProcessingClassTemplate : Cmdlet
{
  // Override the BeginProcessing method to add preprocessing
  //operations to the cmdlet.
  protected override void BeginProcessing()
  {
    // Replace the WriteObject method with the logic required
    // by your cmdlet. It is used here to generate the following
    // output:
    // "This is a test of the BeginProcessing template."
    WriteObject("This is a test of the BeginProcessing template.");
  }
}

Pour substituer la méthode ProcessRecord

• Déclarez une substitution protégée de la méthode System. Management. Automation. applet de commande. ProcessRecord.

La classe suivante affiche un exemple de message. Pour utiliser cette classe, modifiez le verbe et le nom dans l’attribut de l’applet de commande, modifiez le nom de la classe pour refléter le nouveau verbe et le nom, puis ajoutez la fonctionnalité dont vous avez besoin à la substitution de la méthode System. Management. Automation. applet de commande. ProcessRecord.

[Cmdlet(VerbsDiagnostic.Test, "ProcessRecordClass")]
public class TestProcessRecordClassTemplate : Cmdlet
{
    // Override the ProcessRecord method to add processing
    //operations to the cmdlet.
    protected override void ProcessRecord()
    {
        // Replace the WriteObject method with the logic required
        // by your cmdlet. It is used here to generate the following
        // output:
        // "This is a test of the ProcessRecord template."
        WriteObject("This is a test of the ProcessRecord template.");
    }
}

Pour substituer la méthode EndProcessing

• Déclarez une substitution protégée de la méthode System. Management. Automation. applet de commande. EndProcessing.

La classe suivante imprime un exemple. Pour utiliser cette classe, modifiez le verbe et le nom dans l’attribut de l’applet de commande, modifiez le nom de la classe pour refléter le nouveau verbe et le nom, puis ajoutez la fonctionnalité dont vous avez besoin à la substitution de la méthode System. Management. Automation. applet de commande. EndProcessing.

[Cmdlet(VerbsDiagnostic.Test, "EndProcessingClass")]
public class TestEndProcessingClassTemplate : Cmdlet
{
  // Override the EndProcessing method to add postprocessing
  //operations to the cmdlet.
  protected override void EndProcessing()
  {
    // Replace the WriteObject method with the logic required
    // by your cmdlet. It is used here to generate the following
    // output:
    // "This is a test of the BeginProcessing template."
    WriteObject("This is a test of the EndProcessing template.");
  }
}

Voir aussi

System. Management. Automation. applet de commande. BeginProcessing

System. Management. Automation. applet de commande. EndProcessing

System. Management. Automation. applet de commande. ProcessRecord

Écriture d’une applet de commande Windows PowerShell