TestimoX

API Reference

Class

RegistryControl

Namespace ComputerX.Controls
Assembly ComputerX
Modifiers sealed

A registry-backed control that evaluates a single value at a given key/path and supports optional remediation.

Inheritance

  • Object
  • RegistryControl

Constructors

public RegistryControl(String id, String title, String keyPath, String valueName, RegistryValueKind kind, CxValueKind valueKind, CxComparator comparator) #

Creates a new RegistryControl for the specified path/value.

Parameters

id System.String requiredposition: 0
title System.String requiredposition: 1
keyPath System.String requiredposition: 2
valueName System.String requiredposition: 3
kind Microsoft.Win32.RegistryValueKind requiredposition: 4
valueKind ComputerX.Controls.CxValueKind requiredposition: 5
comparator ComputerX.Controls.CxComparator requiredposition: 6

Methods

public virtual CxEval Evaluate(String host, CxFacts facts) #
Returns: CxEval

Parameters

host System.String requiredposition: 0
facts ComputerX.Controls.CxFacts requiredposition: 1
public virtual String GetAnchor() #
Returns: String

Returns the specific registry anchor including scope when available. Format: REG|Hive\\Path|ValueName|Scope where Scope may be null/empty.

public virtual String GetUnifiedAnchor() #
Returns: String

Returns the canonical unified anchor for this registry value. Format: U|REG|Hive\\Path|ValueName (no scope component).

public virtual Boolean IsApplicable(CxFacts facts) #
Returns: Boolean

Parameters

facts ComputerX.Controls.CxFacts requiredposition: 0
public virtual Object ReadCurrent(String host, CxFacts facts) #
Returns: Object

Parameters

host System.String requiredposition: 0
facts ComputerX.Controls.CxFacts requiredposition: 1
public virtual Boolean TryWrite(String host, Object value, out String error) #
Returns: Boolean

Parameters

host System.String requiredposition: 0
value System.Object requiredposition: 1
error System.String@ requiredposition: 2
public RegistryControl WhereIs(CxCondition c) #
Returns: RegistryControl

Sets an applicability predicate.

Parameters

c ComputerX.Controls.CxCondition requiredposition: 0
public RegistryControl WithDesired(CxVendor vendor, Object value, String ruleId = null, String note = null, String description = null, String referenceUrl = null, String severity = null, String category = null, String[] tags = null) #
Returns: RegistryControl

Adds a vendor desired value with optional metadata.

Parameters

vendor ComputerX.Controls.CxVendor requiredposition: 0
value System.Object requiredposition: 1
ruleId System.String = null optionalposition: 2
note System.String = null optionalposition: 3
description System.String = null optionalposition: 4
referenceUrl System.String = null optionalposition: 5
severity System.String = null optionalposition: 6
category System.String = null optionalposition: 7
tags System.String[] = null optionalposition: 8

Properties

public static Func<String, String, String, Object> TestReadOverride { get; set; } #

Optional testing hook: when set, ReadCurrent will delegate to this provider instead of reading the registry. Do not set in production code. Intended for unit tests in environments where HKCU writes are unreliable.

public virtual String Id { get; } #
public virtual String Title { get; } #
public virtual CxValueKind ValueKind { get; } #
public virtual CxComparator Comparator { get; } #
public String KeyPath { get; } #

Absolute registry key path (HKLM/HKU supported).

public String ValueName { get; } #

Registry value name (empty or null refers to the default value).

public RegistryValueKind RegistryKind { get; } #

Registry value kind used for writing.

public CxCondition Where { get; set; } #

Optional applicability predicate.

public virtual IReadOnlyList<CxDesired> Desired { get; } #