Skip to content

Remove .NET Framework remarks (System.Management)#12653

Open
gewarren wants to merge 4 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-management
Open

Remove .NET Framework remarks (System.Management)#12653
gewarren wants to merge 4 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-management

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

@gewarren gewarren commented May 24, 2026

.NET Framework API ref has moved to its own repo (https://github.com/dotnet/dotnetfw-api-docs), so we can clean up .NET Framework remarks, exceptions, and code examples out of this repo. Contributes to #12513.

Removes remarks and examples related to:

  • .NET Framework versions
  • Code-access security
  • Configuring apps via app.config file
  • App domains

Also removes all remarks from obsolete APIs.

Hide whitespace changes

Copilot AI review requested due to automatic review settings May 24, 2026 02:57
@gewarren gewarren requested a review from a team as a code owner May 24, 2026 02:57
@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label May 24, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the System.Management API reference XML to remove .NET Framework-specific content (notably CAS/.NET Framework security remarks), while also normalizing some remarks/value text and tidying markdown formatting around examples.

Changes:

  • Removed “.NET Framework Security” sections and other framework-specific notes across many System.Management types/members.
  • Simplified/normalized <value> and <remarks> text, including some example/markdown formatting cleanup.
  • Introduced placeholder remarks in multiple places (<remarks>To be added.</remarks>) where remarks were removed.

Reviewed changes

Copilot reviewed 46 out of 46 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
xml/System.Management/WqlObjectQuery.xml Removes framework security remarks; adds placeholder remarks.
xml/System.Management/WqlEventQuery.xml Removes framework security remarks; adjusts <value>/remarks and examples formatting.
xml/System.Management/StoppedEventArgs.xml Removes framework security remarks; adds placeholder remarks.
xml/System.Management/SelectQuery.xml Removes framework security remarks; adjusts <value> text.
xml/System.Management/RelationshipQuery.xml Removes framework security remarks; cleans up markdown/example formatting; adds placeholders.
xml/System.Management/RelatedObjectQuery.xml Removes framework security remarks; cleans up markdown/example formatting; adds placeholders.
xml/System.Management/QualifierDataCollection+QualifierDataEnumerator.xml Removes framework security remarks; cleans up examples formatting; adds placeholders.
xml/System.Management/QualifierDataCollection.xml Removes framework security remarks; adds placeholder remarks and trims property value sections.
xml/System.Management/QualifierData.xml Removes framework security remarks; cleans up examples formatting; adds placeholder remarks in several members.
xml/System.Management/PutOptions.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/PropertyDataCollection+PropertyDataEnumerator.xml Removes framework security remarks; cleans up examples formatting; adds placeholders.
xml/System.Management/PropertyDataCollection.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/PropertyData.xml Removes framework security remarks; cleans up examples formatting; adds placeholder remarks in several members.
xml/System.Management/ProgressEventArgs.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/ObjectReadyEventArgs.xml Removes framework security remarks; adjusts <summary>/<value>; adds placeholder remarks.
xml/System.Management/ObjectQuery.xml Removes framework security remarks; adds placeholder remarks; minor whitespace cleanup.
xml/System.Management/ObjectPutEventArgs.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/ObjectGetOptions.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/MethodDataCollection+MethodDataEnumerator.xml Removes framework security remarks; cleans up examples formatting; adds placeholders.
xml/System.Management/MethodDataCollection.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/MethodData.xml Removes framework security remarks/property value sections; adjusts <value> text.
xml/System.Management/ManagementScope.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/ManagementQuery.xml Removes framework security remarks; adds placeholders; cleans up markdown formatting.
xml/System.Management/ManagementPath.xml Removes framework security remarks; adjusts <value> text; cleans up examples formatting; adds placeholders.
xml/System.Management/ManagementOptions.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/ManagementOperationObserver.xml Removes framework security remarks; adds placeholders; minor formatting cleanup.
xml/System.Management/ManagementObjectSearcher.xml Removes framework security remarks; adds placeholders; minor markdown formatting cleanup.
xml/System.Management/ManagementObjectCollection+ManagementObjectEnumerator.xml Removes framework security remarks; adds placeholders.
xml/System.Management/ManagementObjectCollection.xml Removes framework security remarks; adds placeholders; modifies Count remarks.
xml/System.Management/ManagementNamedValueCollection.xml Removes framework security remarks; adds placeholder remarks.
xml/System.Management/ManagementException.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/ManagementEventWatcher.xml Removes framework security remarks; adds placeholders; minor markdown formatting cleanup.
xml/System.Management/ManagementEventArgs.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/ManagementDateTimeConverter.xml Removes framework security remarks; minor text formatting changes in remarks.
xml/System.Management/ManagementBaseObject.xml Removes framework security remarks/property value sections; edits remarks and indexer summary/value text.
xml/System.Management/InvokeMethodOptions.xml Removes framework security remarks; cleans up examples formatting; adds placeholders.
xml/System.Management/EventWatcherOptions.xml Removes framework security remarks; adjusts <value> text; adds placeholders.
xml/System.Management/EventQuery.xml Removes framework security remarks; adds placeholders.
xml/System.Management/EventArrivedEventHandler.xml Cleans up examples formatting and updates wording to remove framework-specific phrasing.
xml/System.Management/EventArrivedEventArgs.xml Removes framework security remarks; cleans up examples formatting; adds placeholders.
xml/System.Management/EnumerationOptions.xml Removes framework security remarks; adjusts <value> text; cleans up examples formatting; adds placeholders.
xml/System.Management/DeleteOptions.xml Removes framework security remarks; adds placeholders.
xml/System.Management/ConnectionOptions.xml Removes framework security remarks; refactors remarks text and <value> strings.
xml/System.Management/CompletedEventArgs.xml Removes framework security remarks; adjusts <summary>/<value>; adds placeholders.

Comment thread xml/System.Management/ConnectionOptions.xml Outdated
Comment thread xml/System.Management/ConnectionOptions.xml Outdated
Comment thread xml/System.Management/SelectQuery.xml
Comment thread xml/System.Management/ManagementDateTimeConverter.xml Outdated
Comment on lines 137 to 140
## Remarks

The lowest precision in DMTF is microseconds; in <xref:System.TimeSpan>, the lowest precision is <xref:System.TimeSpan.Ticks*>, which is equivalent to 100 nanoseconds. During conversion, <xref:System.TimeSpan.Ticks*> are converted to microseconds and rounded off to the nearest microsecond.

## .NET Framework security
Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see [Using Libraries from Partially Trusted Code](/dotnet/framework/misc/using-libraries-from-partially-trusted-code).
The lowest precision in DMTF is microseconds; in <xref:System.TimeSpan>, the lowest precision is <xref:System.TimeSpan.Ticks*>, which is equivalent to 100 nanoseconds. During conversion, <xref:System.TimeSpan.Ticks*> are converted to microseconds and rounded off to the nearest microsecond

Comment thread xml/System.Management/ManagementBaseObject.xml Outdated
Comment thread xml/System.Management/WqlEventQuery.xml
Comment on lines 599 to 602
<Docs>
<summary>Gets or sets the polling interval to be used in this query.</summary>
<value>Returns a <see cref="T:System.TimeSpan" /> value containing the polling interval used in the event query.</value>
<value>The polling interval used in the event query, if polling is required; otherwise, <see langword="null" />.</value>
<remarks>
Comment on lines 53 to 56
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.Management.WqlObjectQuery" /> class. This is the parameterless constructor.</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks

## .NET Framework Security
Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see [Using Libraries from Partially Trusted Code](/dotnet/framework/misc/using-libraries-from-partially-trusted-code).

]]></format>
</remarks>
<remarks>To be added.</remarks>
</Docs>
Comment thread xml/System.Management/ManagementException.xml Outdated
Comment thread xml/System.Management/SelectQuery.xml Outdated
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@gewarren gewarren enabled auto-merge (squash) May 27, 2026 21:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants