ServiceProcessInstaller.Rollback(IDictionary) Yöntem

Tanım

Yükleme yordamı tarafından kayıt defterine yazılan hizmet uygulaması bilgilerini geri kaydeder.Rolls back service application information written to the registry by the installation procedure. Bu yöntem, uygun yöntemleri otomatik olarak işleyen yükleme araçları tarafından kullanılmak üzere tasarlanmıştır.This method is meant to be used by installation tools, which process the appropriate methods automatically.

public:
 override void Rollback(System::Collections::IDictionary ^ savedState);
public override void Rollback (System.Collections.IDictionary savedState);
override this.Rollback : System.Collections.IDictionary -> unit
Public Overrides Sub Rollback (savedState As IDictionary)

Parametreler

savedState
IDictionary

IDictionaryYükleme ile ilişkili bağlam bilgilerini içeren bir.An IDictionary that contains the context information associated with the installation.

Özel durumlar

savedState null .The savedState is null.

-veya--or- savedStateBozuk veya mevcut değil.The savedState is corrupted or non-existent.

Açıklamalar

Normalde, kodunuzun içindeki yöntemleri çağırmayın ServiceProcessInstaller ; genellikle yalnızca Install yardımcı programı tarafından çağırılır.Normally, you do not call the methods on ServiceProcessInstaller within your code; they are generally called only by the install utility. Yükleme yardımcı programı, ServiceProcessInstaller.Install yükleme işlemi sırasında yöntemini otomatik olarak çağırır.The install utility automatically calls the ServiceProcessInstaller.Install method during the installation process. Gerektiğinde, Rollback özel durumu oluşturan nesneyi çağırarak, hatalara geri gelir.It backs out failures, if necessary, by calling Rollback on the object that generated the exception.

Bir uygulamanın yükleme yordamı, proje yükleyicisi 'ni kullanarak zaten yüklü olan bileşenler hakkında bilgileri otomatik olarak korur Installer.Context .An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. Parametresi olarak geçirilen bu durum bilgileri, Rollback savedState örnek olarak, ServiceProcessInstaller her ServiceInstaller örnek yardımcı program tarafından yüklendiği için sürekli olarak güncelleştirilir.This state information, passed into Rollback as the savedState parameter, is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. Kodunuzun bu durum bilgilerini açıkça değiştirmesi genellikle gerekli değildir.It is usually unnecessary for your code to modify this state information explicitly.

Rollbackçağırma yöntemine, temel sınıf yöntemleri veya olay işleyicileri tarafından oluşturulan özel durumlar geçer BeforeInstall / AfterInstall .Rollback passes to the calling method any exceptions thrown by base class methods or BeforeInstall / AfterInstall event handlers.

Şunlara uygulanır

Ayrıca bkz.