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.2.dll

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

csharp

public static event EventHandler<RegistryAccessPolicy.QuerySubKeyTreeOperationEventArgs> DeleteSubKeyTree

Public Shared Event DeleteSubKeyTree As EventHandler(Of RegistryAccessPolicy.QuerySubKeyTreeOperationEventArgs)

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:

C#
VB.NET

csharp

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);
}

Private Shared privatePath As String = "SPECIFY_REGISTRY_PRIVATE_PATH"
Shared Sub Main()
    Application.EnableVisualStyles()
    Application.SetCompatibleTextRenderingDefault(False)
    AddHandler RegistryAccessPolicy.DeleteSubKeyTree, AddressOf RegistryAccessPolicy_DeleteSubKeyTree
    Application.Run(New Form1())
End Sub
Shared Sub RegistryAccessPolicy_DeleteSubKeyTree(ByVal sender As Object, ByVal e As RegistryAccessPolicy.QuerySubKeyTreeOperationEventArgs)
  e.Cancel = e.Key.Contains(privatePath)
End Sub

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