ProgressRecord Class

Definition

Namespace:

System.Management.Automation

Assembly:

System.Management.Automation.dll

Package:

System.Management.Automation v7.4.0

Defines a data structure used to represent the status of an ongoing operation at a point in time.

public ref class ProgressRecord

[System.Runtime.Serialization.DataContract]
public class ProgressRecord

[<System.Runtime.Serialization.DataContract>]
type ProgressRecord = class

Public Class ProgressRecord

Inheritance

Object

ProgressRecord

Derived

System.Management.Automation.Runspaces.RemotingProgressRecord

Attributes

DataContractAttribute

Remarks

ProgressRecords are passed to WriteProgress(ProgressRecord), which, according to user preference, forwards that information on to the host for rendering to the user.

Constructors

ProgressRecord(Int32)	Initializes a new instance of the ProgressRecord class and defines the activity Id.
ProgressRecord(Int32, String, String)	Initializes a new instance of the ProgressRecord class and defines the activity Id, activity description, and status description.

Properties

Activity	Gets and sets the description of the activity for which progress is being reported.
ActivityId	Gets the Id of the activity to which this record corresponds. Used as a 'key' for the linking of subordinate activities.
CurrentOperation	Gets and sets the current operation of the many required to accomplish the activity (such as "copying foo.txt"). Normally displayed below its associated progress bar, e.g., "deleting file foo.bar" Set to null or empty in the case a sub-activity will be used to show the current operation.
ParentActivityId	Gets and sets the Id of the activity for which this record is a subordinate.
PercentComplete	Gets and sets the estimate of the percentage of total work for the activity that is completed. Typically displayed as a progress bar. Set to a negative value to indicate that the percentage completed should not be displayed.
RecordType	Gets and sets the type of record represented by this instance.
SecondsRemaining	Gets and sets the estimate of time remaining until this activity is completed. This can be based upon a measurement of time since started and the percent complete or another approach deemed appropriate by the caller. Normally displayed beside the progress bar, as "N seconds remaining."
StatusDescription	Gets and sets the current status of the operation, e.g., "35 of 50 items Copied." or "95% completed." or "100 files purged."

Methods

ToString()

Overrides ToString()

See also

• WriteProgress(ProgressRecord)