Skip to content

Add cryptographic security note to System.Random API docs #12481

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
gewarren merged 2 commits into from
Apr 2, 2026
+8 −1
Merged

Add cryptographic security note to System.Random API docs #12481

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2b82166
Initial plan
Copilot Apr 2, 2026
43ce8b5
Add cryptographic security NOTE to System.Random type-level remarks
Copilot Apr 2, 2026
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
9 changes: 8 additions & 1 deletion xml/System/Random.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,14 @@
</Attributes>
<Docs>
<summary>Represents a pseudo-random number generator, which is an algorithm that produces a sequence of numbers that meet certain statistical requirements for randomness.</summary>
<remarks>For more information about this API, see <see href="/dotnet/fundamentals/runtime-libraries/system-random">Supplemental API remarks for Random</see>.</remarks>
<remarks>
<format type="text/markdown"><![CDATA[
> [!NOTE]
> To generate a cryptographically secure random number, such as one that's suitable for creating a random password, use one of the static methods in the <xref:System.Security.Cryptography.RandomNumberGenerator> class.

For more information about this API, see [Supplemental API remarks for Random](/dotnet/fundamentals/runtime-libraries/system-random).
]]></format>
</remarks>
<example>
<format type="text/markdown"><![CDATA[
The following example creates a single random number generator and calls its <xref:System.Random.NextBytes*>, <xref:System.Random.Next*>, and <xref:System.Random.NextDouble*> methods to generate sequences of random numbers within different ranges.
Expand Down
Loading