TestimoX

API Reference

Class

DocumentationControl

Namespace ComputerX.Controls
Assembly ComputerX
Implements
Modifiers sealed

Informational control that carries vendor documentation only (no evaluation/write). Useful to surface DocOnly baseline rows in cmdlets and UIs.

Inheritance

  • Object
  • DocumentationControl

Constructors

public DocumentationControl(String id, String title) #

Creates a documentation-only control with an id and title.

Parameters

id System.String requiredposition: 0
title System.String requiredposition: 1

Methods

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

Returns a pass result with vendor desired values for display.

Parameters

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

Returns true for all inputs (documentation-only control).

Parameters

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

Returns the current value (description or title) for display.

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

Always returns false; documentation-only controls cannot write.

Parameters

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

Sets an applicability condition for the control.

Parameters

c ComputerX.Controls.CxCondition requiredposition: 0
public DocumentationControl WithMetadata(String description, String referenceUrl, String severity, String category, String[] tags) #
Returns: DocumentationControl

Attaches optional metadata and infers a vendor source from tags.

Parameters

description System.String requiredposition: 0
referenceUrl System.String requiredposition: 1
severity System.String requiredposition: 2
category System.String requiredposition: 3
tags System.String[] requiredposition: 4

Properties

public virtual String Id { get; } #

Unique identifier for the control.

public virtual String Title { get; } #

Short title for the documentation item.

public String Description { get; set; } #

Optional descriptive text.

public String ReferenceUrl { get; set; } #

Optional reference URL (CIS/STIG/MSB page, blog, KB, etc.).

public String Severity { get; set; } #

Optional severity label (Informational/Low/Medium/High).

public String Category { get; set; } #

Optional category label.

public virtual CxValueKind ValueKind { get; } #

Value kind reported by the control (always string for DocOnly).

public virtual CxComparator Comparator { get; } #

Comparator semantics (always Exact for DocOnly).

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

Desired target values by vendor source (CIS/STIG/MSB/Custom).

public CxCondition Where { get; set; } #

Optional applicability condition.