Skip to main content
All docs
V25.1
  • RegistryAccessPolicy.DeleteSubKeyTree Event

    Fires when the DevExpress control attempts to delete a subkey from the system registry and allows you to cancel the operation.

    Namespace: DevExpress.Data.Utils

    Assembly: DevExpress.Data.Desktop.v25.1.dll

    NuGet Packages: DevExpress.Data.Desktop, DevExpress.ExpressApp.Win.Design

    #Declaration

    #Event Data

    The DeleteSubKeyTree event's data class is RegistryAccessPolicy.QuerySubKeyTreeOperationEventArgs. The following properties provide information specific to this event:

    Property Description
    Cancel Gets or sets a value indicating whether the event should be canceled. Inherited from CancelEventArgs.
    Hive Gets a registry hive (a logical group of keys, subkeys, and values in the registry). Inherited from RegistryAccessPolicy.RegistryOperationBaseEventArgs.
    Key Gets the requested registry key. Inherited from RegistryAccessPolicy.RegistryOperationBaseEventArgs.
    Operation Gets the operation performed on the subkey.

    #Remarks

    Set the e.Cancel event parameter to true to cancel the operation. e.Hive and e.Key event parameters identify a registry hive and key.

    The following example suppresses attempts to delete subkeys from the specified system registry path:

    static string privatePath = "SPECIFY_REGISTRY_PRIVATE_PATH";
    static void Main() {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        RegistryAccessPolicy.DeleteSubKeyTree += RegistryAccessPolicy_DeleteSubKeyTree;
        Application.Run(new Form1());
    }
    static void RegistryAccessPolicy_DeleteSubKeyTree(object sender, RegistryAccessPolicy.QuerySubKeyTreeOperationEventArgs e) {
        e.Cancel = e.Key.Contains(privatePath);
    }
    

    Read the following topic for additional information: Registry Access Policy.

    See Also