Skip to content

Commit b0073fd

Browse files
authored
Update EF Core tooling breaking change remarks (#35462)
1 parent 212fd10 commit b0073fd

File tree

1 file changed

+12
-38
lines changed
  • aspnetcore/blazor/tutorials/movie-database-app

1 file changed

+12
-38
lines changed

aspnetcore/blazor/tutorials/movie-database-app/part-2.md

Lines changed: 12 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -134,32 +134,18 @@ dotnet add package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore
134134
> [!IMPORTANT]
135135
> After the first eight commands execute, make sure that you press <kbd>Enter</kbd> on the keyboard to execute the last command.
136136
137-
:::moniker range=">= aspnetcore-9.0"
137+
:::moniker range=">= aspnetcore-9.0 < aspnetcore-10.0"
138138

139-
<!-- UPDATE 10.0 - Remove this when the 9.0.300 SDK lands. -->
139+
<!-- UPDATE 10.0 - Remove at 10.0 GA -->
140140

141141
> [!IMPORTANT]
142-
> A breaking change in EF Core tooling for .NET SDK 9.0.200 prevents scaffolding from executing with the following exception:
142+
> A breaking change in EF Core tooling for .NET SDK 9.0.200 prevented scaffolding from executing with the following exception:
143143
>
144144
> > :::no-loc text="Could not load file or assembly 'Microsoft.EntityFrameworkCore.Design, Version=9.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified.":::
145145
>
146-
> To resolve the error until the .NET SDK 9.0.300 is released, add a package reference to the app for the [`Microsoft.EntityFrameworkCore.Design`](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Design) NuGet package:
147-
>
148-
> ```dotnetcli
149-
> dotnet add package Microsoft.EntityFrameworkCore.Design
150-
> ```
151-
>
152-
> Open the app's project file (`BlazorWebAppMovies.csproj`). Mark the `Microsoft.EntityFrameworkCore.Design` assembly reference as publishable by adding `<Publish>true</Publish>` to the package reference. In the following example, the `{VERSION}` placeholder is the package's version and remains unchanged:
146+
> To resolve the error, upgrade to a .NET SDK of 9.0.300 or later.
153147
>
154-
> ```diff
155-
> <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="{VERSION}">
156-
> <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
157-
> <PrivateAssets>all</PrivateAssets>
158-
> + <Publish>true</Publish>
159-
> </PackageReference>
160-
> ```
161-
>
162-
> The preceding changes are a workaround for a breaking change in .NET 9.0.200 EF Core tooling. This workaround won't be required for .NET SDK 9.0.300 or later, when the entire package reference can be removed from the app. For more information, see [Breaking changes in EF Core 9 (EF9)](/ef/core/what-is-new/ef-core-9.0/breaking-changes#microsoftentityframeworkcoredesign-not-found-when-using-ef-tools).
148+
> For more information, see [Breaking changes in EF Core 9 (EF9)](/ef/core/what-is-new/ef-core-9.0/breaking-changes#microsoftentityframeworkcoredesign-not-found-when-using-ef-tools).
163149
164150
:::moniker-end
165151

@@ -205,32 +191,20 @@ dotnet add package Microsoft.AspNetCore.Components.QuickGrid.EntityFrameworkAdap
205191
dotnet add package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore
206192
```
207193

208-
:::moniker range=">= aspnetcore-9.0"
194+
:::moniker range=">= aspnetcore-9.0 < aspnetcore-10.0"
209195

210-
<!-- UPDATE 10.0 - Remove this when the 9.0.300 SDK lands. -->
196+
<!-- UPDATE 10.0 - Remove at 10.0 GA -->
211197

212198
> [!IMPORTANT]
213-
> A breaking change in EF Core tooling for .NET SDK 9.0.200 prevents scaffolding from executing with the following exception:
199+
> A breaking change in EF Core tooling for .NET SDK 9.0.200 prevented scaffolding from executing with the following exception:
214200
>
215201
> > :::no-loc text="Could not load file or assembly 'Microsoft.EntityFrameworkCore.Design, Version=9.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified.":::
216202
>
217-
> To resolve the error until the .NET SDK 9.0.300 is released, add a package reference to the app for the [`Microsoft.EntityFrameworkCore.Design`](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Design) NuGet package:
203+
> To resolve the error, upgrade to a .NET SDK of 9.0.300 or later.
218204
>
219-
> ```dotnetcli
220-
> dotnet add package Microsoft.EntityFrameworkCore.Design
221-
> ```
222-
>
223-
> Open the app's project file (`BlazorWebAppMovies.csproj`). Mark the `Microsoft.EntityFrameworkCore.Design` assembly reference as publishable by adding `<Publish>true</Publish>` to the package reference. In the following example, the `{VERSION}` placeholder is the package's version and remains unchanged:
224-
>
225-
> ```diff
226-
> <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="{VERSION}">
227-
> <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
228-
> <PrivateAssets>all</PrivateAssets>
229-
> + <Publish>true</Publish>
230-
> </PackageReference>
231-
> ```
232-
>
233-
> The preceding changes are a workaround for a breaking change in .NET 9.0.200 EF Core tooling. This workaround won't be required for .NET SDK 9.0.300 or later, when the entire package reference can be removed from the app. For more information, see [Breaking changes in EF Core 9 (EF9)](/ef/core/what-is-new/ef-core-9.0/breaking-changes#microsoftentityframeworkcoredesign-not-found-when-using-ef-tools).
205+
> For more information, see [Breaking changes in EF Core 9 (EF9)](/ef/core/what-is-new/ef-core-9.0/breaking-changes#microsoftentityframeworkcoredesign-not-found-when-using-ef-tools).
206+
207+
:::moniker-end
234208

235209
:::moniker-end
236210

0 commit comments

Comments
 (0)