Skip to content

Commit c9cb979

Browse files
authored
Add examples to roll-forward table (#46238)
* Add examples to roll-forward table * Move explanation away from transclude template * Tweak wording
1 parent 713cb27 commit c9cb979

File tree

2 files changed

+18
-6
lines changed

2 files changed

+18
-6
lines changed

docs/core/versions/selection.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,18 @@ However you set the roll-forward setting, use one of the following values to set
159159

160160
[!INCLUDE [roll-forward-table](../../../includes/roll-forward-table.md)]
161161

162+
For example, suppose an application requests version `8.0.0`, while the locally available versions are `8.2.0`, `8.2.3`, `8.4.5`, `9.0.0`, `9.0.6`, `9.7.8`.
163+
Then the resolved version is as follows in each case:
164+
165+
| Value | Resolved version | Resolved version if `8.0.1` were also available |
166+
|---------------|------------------|-------------------------------------------------|
167+
| `Minor` | `8.2.3` | `8.0.1` |
168+
| `Major` | `8.2.3` | `8.0.1` |
169+
| `LatestPatch` | (fails) | `8.0.1` |
170+
| `LatestMinor` | `8.4.5` | `8.4.5` |
171+
| `LatestMajor` | `9.7.8` | `9.7.8` |
172+
| `Disable` | (fails) | (fails) |
173+
162174
## Self-contained deployments include the selected runtime
163175

164176
You can publish an application as a [**self-contained distribution**](../deploying/index.md#publish-self-contained). This approach bundles the .NET runtime and libraries with your application. Self-contained deployments don't have a dependency on runtime environments. Runtime version selection occurs at publishing time, not run time.

includes/roll-forward-table.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
author: adegeo
33
ms.author: adegeo
4-
ms.date: 07/08/2021
4+
ms.date: 05/16/2025
55
ms.topic: include
66
recommendations: false
77
---
88

99
| Value | Description |
1010
|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
11-
| `Minor` | **Default** if not specified.<br>Roll-forward to the lowest higher minor version, if requested minor version is missing. If the requested minor version is present, then the `LatestPatch` policy is used. |
12-
| `Major` | Roll-forward to the next available higher major version, and lowest minor version, if requested major version is missing. If the requested major version is present, then the `Minor` policy is used. |
13-
| `LatestPatch` | Roll-forward to the highest patch version. This value disables minor version roll-forward. |
14-
| `LatestMinor` | Roll-forward to highest minor version, even if requested minor version is present. |
15-
| `LatestMajor` | Roll-forward to highest major and highest minor version, even if requested major is present. |
11+
| `Minor` | **Default** if not specified.<br>Roll-forward to the next available higher minor version (and highest available patch version within that minor version), if requested minor version is missing. If the requested minor version is present, then the `LatestPatch` policy is used. |
12+
| `Major` | Roll-forward to the next available higher major version (at its lowest available minor version, and highest available patch version within that minor version), if requested major version is missing. If the requested major version is present, then the `Minor` policy is used. |
13+
| `LatestPatch` | Roll-forward to the highest patch version available for the requested major and minor versions. This value disables minor version roll-forward. |
14+
| `LatestMinor` | Roll-forward to the highest minor version available for the requested major version (and highest available patch version within that minor version), even if requested minor version is present. |
15+
| `LatestMajor` | Roll-forward to highest available major version (and highest available minor and patch version within that major version), even if requested major is present. |
1616
| `Disable` | Don't roll-forward, only bind to the specified version. This policy isn't recommended for general use since it disables the ability to roll-forward to the latest patches. This value is only recommended for testing. |

0 commit comments

Comments
 (0)