Skip to content

Merge main into live #12057

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 19, 2025
+688 −686
Merged

Merge main into live #12057

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9894846
Clarify IReflect interface COM casting behavior (#12051)
AaronRobinsonMSFT Nov 17, 2025
d7a3c99
Fix various inheritdoc so there is only "one indirection" (#12052)
tannergooding Nov 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions xml/System.Numerics/Vector.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3982,7 +3982,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.ExtractMostSignificantBits(System.Numerics.Vector4)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ExtractMostSignificantBits``1(System.Runtime.Intrinsics.Vector128{``0})" />
</Docs>
</Member>
<Member MemberName="ExtractMostSignificantBits">
Expand Down Expand Up @@ -4017,7 +4017,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.ExtractMostSignificantBits(System.Numerics.Vector4)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ExtractMostSignificantBits``1(System.Runtime.Intrinsics.Vector128{``0})" />
</Docs>
</Member>
<Member MemberName="ExtractMostSignificantBits">
Expand Down Expand Up @@ -4243,7 +4243,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.GetElement(System.Numerics.Vector4,System.Int32)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.GetElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32)" />
</Docs>
</Member>
<Member MemberName="GetElement">
Expand Down Expand Up @@ -4274,7 +4274,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.GetElement(System.Numerics.Vector4,System.Int32)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.GetElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32)" />
</Docs>
</Member>
<Member MemberName="GetElement">
Expand Down Expand Up @@ -11279,7 +11279,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.ToScalar(System.Numerics.Vector4)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ToScalar``1(System.Runtime.Intrinsics.Vector128{``0})" />
</Docs>
</Member>
<Member MemberName="ToScalar">
Expand Down Expand Up @@ -11308,7 +11308,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.ToScalar(System.Numerics.Vector4)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.ToScalar``1(System.Runtime.Intrinsics.Vector128{``0})" />
</Docs>
</Member>
<Member MemberName="ToScalar">
Expand Down Expand Up @@ -12314,7 +12314,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.WithElement(System.Numerics.Vector4,System.Int32,System.Single)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.WithElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32,``0)" />
</Docs>
</Member>
<Member MemberName="WithElement">
Expand Down Expand Up @@ -12347,7 +12347,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Numerics.Vector.WithElement(System.Numerics.Vector4,System.Int32,System.Single)" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.WithElement``1(System.Runtime.Intrinsics.Vector128{``0},System.Int32,``0)" />
</Docs>
</Member>
<Member MemberName="WithElement">
Expand Down
147 changes: 73 additions & 74 deletions xml/System.Numerics/Vector2.xml
View file
Open in desktop

Large diffs are not rendered by default.

147 changes: 73 additions & 74 deletions xml/System.Numerics/Vector3.xml
View file
Open in desktop

Large diffs are not rendered by default.

3 changes: 1 addition & 2 deletions xml/System.Numerics/Vector4.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2016,7 +2016,7 @@
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.MultiplyAddEstimate(System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single})" />
<inheritdoc cref="M:System.Runtime.Intrinsics.Vector128.FusedMultiplyAdd(System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single},System.Runtime.Intrinsics.Vector128{System.Single})" />
</Docs>
</Member>
<Member MemberName="GetHashCode">
Expand Down Expand Up @@ -3100,7 +3100,6 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi

]]></format>
</remarks>
<inheritdoc cref="M:System.Numerics.Vector4.Lerp(System.Numerics.Vector4,System.Numerics.Vector4,System.Numerics.Vector4)" />
</Docs>
</Member>
<Member MemberName="LessThan">
Expand Down
4 changes: 2 additions & 2 deletions xml/System.Numerics/Vector`1.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2257,9 +2257,9 @@ The type `T` can be any of the following numeric types:
<Docs>
<param name="left">The first vector to compare.</param>
<param name="right">The second vector to compare.</param>
<summary>Returns a value that indicates whether any single pair of elements in the specified vectors is equal.</summary>
<summary>Returns a value that indicates whether any single pair of elements in the specified vectors is not equal.</summary>
<returns>
<see langword="true" /> if any element pairs in left and right are equal. <see langword="false" /> if no element pairs are equal.</returns>
<see langword="true" /> if any element pairs in left and right are not equal. <see langword="false" /> if all element pairs are equal.</returns>
<remarks>To be added.</remarks>
<exception cref="T:System.NotSupportedException">.NET 5 and later: Type <see langword="T" /> is not supported.</exception>
</Docs>
Expand Down
7 changes: 6 additions & 1 deletion xml/System.Reflection/IReflect.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,12 @@
<format type="text/markdown"><![CDATA[

## Remarks
The <xref:System.Reflection.IReflect> interface is used to interoperate with the [IDispatch interface](/windows/win32/api/oaidl/nn-oaidl-idispatch). <xref:System.Reflection.IReflect> defines a subset of the <xref:System.Type> reflection methods. Implementing this interface enables a type to customize its behavior when the object is being accessed from COM as an `IDispatch` object. The <xref:System.Runtime.InteropServices.CustomMarshalers.ExpandoToDispatchExMarshaler> class can be used to marshal an object that implements <xref:System.Reflection.IReflect> or <xref:System.Runtime.InteropServices.Expando.IExpando> as a COM `IDispatch` object, and vice versa.

In .NET 10 and later versions, no COM object casts successfully to this interface. If you need access, it's recommended to project and define a managed definition of `IDispatch` or `IDispatchEx`.

In .NET 5 through .NET 9, COM objects that implement `IDispatchEx` can be cast to this interface, but all methods throw `TypeLoadException`.

On .NET Framework, the <xref:System.Reflection.IReflect> interface is used to interoperate with the [IDispatch interface](/windows/win32/api/oaidl/nn-oaidl-idispatch). <xref:System.Reflection.IReflect> defines a subset of the <xref:System.Type> reflection methods. Implementing this interface enables a type to customize its behavior when the object is being accessed from COM as an `IDispatch` object. The <xref:System.Runtime.InteropServices.CustomMarshalers.ExpandoToDispatchExMarshaler> class can be used to marshal an object that implements <xref:System.Reflection.IReflect> or <xref:System.Runtime.InteropServices.Expando.IExpando> as a COM `IDispatch` object, and vice versa.

]]></format>
</remarks>
Expand Down
Loading