Bearbetningsmetoder för cmdlet-indata

Cmdletar måste åsidosätta en eller flera av de metoder för bearbetning av indata som beskrivs i det här avsnittet för att utföra sitt arbete. Dessa metoder tillåter att cmdleten utför åtgärder för för bearbetning, bearbetning av indata och efter bearbetning. Med dessa metoder kan du även stoppa cmdlet-bearbetning. Ett mer detaljerat exempel på hur du använder dessa metoder finns i självstudier om SelectStr.

För bearbetnings åtgärder

-Cmdletar ska åsidosätta metoden system. Management. Automation. cmdlet. BeginProcessing för att lägga till eventuella för bearbetnings åtgärder som är giltiga för alla poster som ska bearbetas senare av cmdleten. När PowerShell bearbetar en kommando pipeline anropar PowerShell denna metod en gång för varje instans av cmdlet: en i pipelinen. Mer information om hur PowerShell anropar kommando pipelinen finns i cmdlet bearbetning livs cykel.

Följande kod visar en implementering av BeginProcessing-metoden.

protected override void BeginProcessing()
{
  // Replace the WriteObject method with the logic required by your cmdlet.
  WriteObject("This is a test of the BeginProcessing template.");
}

Åtgärder för bearbetning av aktiviteter

-Cmdletar kan åsidosätta metoden system. Management. Automation. cmdlet. ProcessRecord för att bearbeta InInformationen som skickas till cmdleten. När PowerShell bearbetar en kommando pipeline anropar PowerShell den här metoden för varje indatamängd som bearbetas av cmdleten. Mer information om hur PowerShell anropar kommando pipelinen finns i cmdlet bearbetning livs cykel.

Följande kod visar en implementering av ProcessRecord-metoden.

protected override void ProcessRecord()
{
  // Replace the WriteObject method with the logic required by your cmdlet.
  WriteObject("This is a test of the ProcessRecord template.");
}

Efter bearbetnings åtgärder

Cmdletar ska åsidosätta metoden system. Management. Automation. cmdlet. EndProcessing för att lägga till eventuella efter bearbetnings åtgärder som är giltiga för alla poster som bearbetats av cmdleten. Din cmdlet kan till exempel behöva rensa objektvariabler när den har bearbetats.

När PowerShell bearbetar en kommando pipeline anropar PowerShell denna metod en gång för varje instans av cmdlet: en i pipelinen. Det är dock viktigt att komma ihåg att PowerShell-körningen inte anropar EndProcessing-metoden om cmdleten avbryts halvvägs genom indata-bearbetningen eller om ett avslutande fel inträffar i någon del av cmdleten. Därför bör en cmdlet som kräver rensning av objekt implementera hela system. IDisposable -mönstret, inklusive en slutförd, så att körningen kan anropa både EndProcessing-och system. IDisposable. Dispose -metoderna i slutet av bearbetningen. Mer information om hur PowerShell anropar kommando pipelinen finns i cmdlet bearbetning livs cykel.

Följande kod visar en implementering av metoden EndProcessing.

protected override void EndProcessing()
{
  // Replace the WriteObject method with the logic required by your cmdlet.
  WriteObject("This is a test of the EndProcessing template.");
}

Se även

System. Management. Automation. cmdlet. BeginProcessing

System. Management. Automation. cmdlet. ProcessRecord

System. Management. Automation. cmdlet. EndProcessing

Självstudie om SelectStr

System. IDisposable

Windows PowerShell Shell SDK