How to Override Input Processing Methods (Como Substituir Métodos de Processamento de Entrada)

Estes exemplos mostram como substituir os métodos de processamento de entrada dentro de um cmdlet. Estes métodos são utilizados para executar as seguintes operações:

O método System.Management.Automation.Cmdlet.BeginProcessing é utilizado para executar operações de arranque únicas que sejam válidas para todos os objetos processados pelo cmdlet. O tempo de execução Windows PowerShell chama este método apenas uma vez.
O método System.Management.Automation.Cmdlet.ProcessRecord é utilizado para processar os objetos passados para o cmdlet. O tempo de execução Windows PowerShell chama este método para cada objeto passado para o cmdlet.
O método System.Management.Automation.Cmdlet.EndProcessing é utilizado para executar operações de processamento pós-operações únicas. O tempo de execução Windows PowerShell chama este método apenas uma vez.

Para anular o método De Processamento de Início

Declare uma sobreposição protegida do método System.Management.Automation.Cmdlet.BeginProcessing.

A seguinte classe imprime uma mensagem de amostra. Para utilizar esta classe, altere o verbo e o substantivo no atributo Cmdlet, altere o nome da classe para refletir o novo verbo e substantivo e, em seguida, adicione a funcionalidade necessária à substituição do método System.Management.Automation.Cmdlet.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.");
  }
}

Para anular o método ProcessRecord

Declare uma sobreposição protegida do método System.Management.Automation.Cmdlet.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.");
    }
}

Para anular o método EndProcessing

Declare uma sobreposição protegida do método System.Management.Automation.Cmdlet.EndProcessing.

A seguinte classe imprime uma amostra. Para utilizar esta classe, altere o verbo e o substantivo no atributo Cmdlet, altere o nome da classe para refletir o novo verbo e substantivo e, em seguida, adicione a funcionalidade necessária à substituição do método System.Management.Automation.Cmdlet.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.");
  }
}

Consulte também

System.Management.Automation.Cmdlet.BeginProcessing

System.Management.Automation.Cmdlet.EndProcessing

System.Management.Automation.Cmdlet.ProcessRecord

Writing a Windows PowerShell Cmdlet (Escrever um Cmdlet do Windows PowerShell)

Last updated on 2021-09-27