Cmdlet Giriş İşleme Yöntemleri
Cmdlet'ler, çalışmalarını gerçekleştirmek için bu konuda açıklanan giriş işleme yöntemlerinden birini veya daha fazlasını geçersiz kıldı. Bu yöntemler cmdlet'in ön işleme, giriş işleme ve son işleme işlemlerini gerçekleştirmesine olanak sağlar. Bu yöntemler cmdlet işlemeyi durdurmayı da sağlar. Bu yöntemlerin kullanımına ilişkin daha ayrıntılı bir örnek için bkz. SelectStr Öğreticisi.
Ön İşleme İşlemleri
Cmdlet'ler, daha sonra cmdlet'i tarafından işlenecek tüm kayıtlar için geçerli olan ön işleme işlemlerini eklemek için System.Management.Automation.Cmdlet.BeginProcessing yöntemini geçersiz kıldı. PowerShell bir komut işlem hattını işlese, PowerShell işlem hattında cmdlet'in her örneği için bu yöntemi bir kez arar. PowerShell'in komut işlem hattını çağırma hakkında daha fazla bilgi için bkz. Cmdlet İşleme Yaşam Döngüsü.
Aşağıdaki kod BeginProcessing yönteminin uygulamasını gösterir.
protected override void BeginProcessing()
{
// Replace the WriteObject method with the logic required by your cmdlet.
WriteObject("This is a test of the BeginProcessing template.");
}
Giriş İşleme İşlemleri
Cmdlet'ler, cmdlet'e gönderilen girişi işlemesi için System.Management.Automation.Cmdlet.ProcessRecord yöntemini geçersiz kıldı. PowerShell bir komut işlem hattını işledikten sonra, PowerShell cmdlet'i tarafından işlenen her giriş kaydı için bu yöntemi arar. PowerShell'in komut işlem hattını çağırma hakkında daha fazla bilgi için bkz. Cmdlet İşleme Yaşam Döngüsü.
Aşağıdaki kod, ProcessRecord yönteminin uygulamasını gösterir.
protected override void ProcessRecord()
{
// Replace the WriteObject method with the logic required by your cmdlet.
WriteObject("This is a test of the ProcessRecord template.");
}
İşleme Sonrası İşlemler
Cmdlet'ler, cmdlet tarafından işlenen tüm kayıtlar için geçerli olan işleme sonrası işlemleri eklemek için System.Management.Automation.Cmdlet.EndProcessing yöntemini geçersiz kılmalı. Örneğin, cmdlet'inizin işlemeyi bitirdikten sonra nesne değişkenlerini temizlemesi gerekir.
PowerShell bir komut işlem hattını işlese, PowerShell işlem hattında cmdlet'in her örneği için bu yöntemi bir kez arar. Ancak, cmdlet giriş işlemi boyunca iptal edilirse veya cmdlet'in herhangi bir bölümünde sonlandırıcı bir hata oluşursa PowerShell çalışma zamanının EndProcessing yöntemini çağırmayacaklarını unutmayın. Bu nedenle, nesne temizlemesi gerektiren bir cmdlet, sonlandırıcı da dahil olmak üzere tam System.IDisposable desenini uygulamalı, böylece çalışma zamanı işlemenin sonunda hem EndProcessing hem de System.IDisposable.Dispose yöntemlerini çağırabilir. PowerShell'in komut işlem hattını çağırma hakkında daha fazla bilgi için bkz. Cmdlet İşleme Yaşam Döngüsü.
Aşağıdaki kod, EndProcessing yönteminin uygulamasını gösterir.
protected override void EndProcessing()
{
// Replace the WriteObject method with the logic required by your cmdlet.
WriteObject("This is a test of the EndProcessing template.");
}
Ayrıca Bkz.
System.Management.Automation.Cmdlet.BeginProcessing
System.Management.Automation.Cmdlet.ProcessRecord
Geri Bildirim
Gönderin ve geri bildirimi görüntüleyin