Skip to content

Commit 1e21afb

Browse files
authored
Update docs for Random.GetItems
1 parent a97aeb7 commit 1e21afb

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

xml/System/Random.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -299,7 +299,7 @@ The following example uses the parameterless constructor to instantiate three <x
299299
<param name="length">The length of array to return.</param>
300300
<summary>Creates an array populated with items chosen at random from the provided set of choices.</summary>
301301
<returns>An array populated with random items.</returns>
302-
<remarks>The method uses <see cref="M:System.Random.Next(System.Int32)" /> to select items randomly from <paramref name="choices" /> by index. This is used to populate a newly-created array.</remarks>
302+
<remarks>The method uses other methods from this instance to select items randomly from <paramref name="choices" /> by index. This is used to populate a newly-created array. If a seed was provided to create the instance, the results of this method are deterministic, however changes in the algorithm employed may yield different results between major versions of .NET.</remarks>
303303
<exception cref="T:System.ArgumentException">
304304
<paramref name="choices" /> is empty.</exception>
305305
<exception cref="T:System.ArgumentOutOfRangeException">
@@ -363,7 +363,7 @@ The following example uses the parameterless constructor to instantiate three <x
363363
<param name="choices">The items to use to populate the span.</param>
364364
<param name="destination">The span to be filled with items.</param>
365365
<summary>Fills the elements of a specified span with items chosen at random from the provided set of choices.</summary>
366-
<remarks>The method uses <see cref="M:System.Random.Next(System.Int32)" /> to select items randomly from <paramref name="choices" /> by index and populate <paramref name="destination" />.</remarks>
366+
<remarks>The method uses other methods on this instance to select items randomly from <paramref name="choices" /> by index and populate <paramref name="destination" />. If a seed was provided to create the instance, the results of this method are deterministic, however changes in the algorithm employed may yield different results between major versions of .NET.</remarks>
367367
<exception cref="T:System.ArgumentException">
368368
<paramref name="choices" /> is empty.</exception>
369369
</Docs>
@@ -413,7 +413,7 @@ The following example uses the parameterless constructor to instantiate three <x
413413
<param name="length">The length of array to return.</param>
414414
<summary>Creates an array populated with items chosen at random from the provided set of choices.</summary>
415415
<returns>An array populated with random items.</returns>
416-
<remarks>The method uses <see cref="M:System.Random.Next(System.Int32)" /> to select items randomly from <paramref name="choices" /> by index. This is used to populate a newly-created array.</remarks>
416+
<remarks>The method uses other methods on this instance to select items randomly from <paramref name="choices" /> by index. This is used to populate a newly-created array. If a seed was provided to create the instance, the results of this method are deterministic, however changes in the algorithm employed may yield different results between major versions of .NET.</remarks>
417417
<exception cref="T:System.ArgumentException">
418418
<paramref name="choices" /> is empty.</exception>
419419
<exception cref="T:System.ArgumentNullException">

0 commit comments

Comments
 (0)