Skip to content

Commit ee8e7b1

Browse files
Copilotnkolev92
andauthored
Document NU1019 error for disallowed characters in TargetFramework names
Agent-Logs-Url: https://github.com/NuGet/docs.microsoft.com-nuget/sessions/939ab205-9284-4871-b331-25cae2734b0a Co-authored-by: nkolev92 <[email protected]>
1 parent b24ad7b commit ee8e7b1

2 files changed

Lines changed: 51 additions & 1 deletion

File tree

docs/reference/Errors-and-Warnings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ NuGet supports the following configuration properties.
2727

2828
| Group | Error Numbers |
2929
| --- | --- |
30-
| Invalid input errors | [NU1001](./errors-and-warnings/NU1001.md), [NU1002](./errors-and-warnings/NU1002.md), [NU1003](./errors-and-warnings/NU1003.md), [NU1004](./errors-and-warnings/NU1004.md), [NU1005](./errors-and-warnings/NU1005.md), [NU1006](./errors-and-warnings/NU1006.md), [NU1007](./errors-and-warnings/NU1007.md), [NU1008](./errors-and-warnings/NU1008.md), [NU1009](./errors-and-warnings/NU1009.md), [NU1010](./errors-and-warnings/NU1010.md), [NU1011](./errors-and-warnings/NU1011.md), [NU1012](./errors-and-warnings/NU1012.md), [NU1013](./errors-and-warnings/NU1013.md), [NU1014](./errors-and-warnings/NU1014.md), [NU1015](./errors-and-warnings/NU1015.md), [NU1016](./errors-and-warnings/NU1016.md), [NU1017](./errors-and-warnings/NU1017.md) |
30+
| Invalid input errors | [NU1001](./errors-and-warnings/NU1001.md), [NU1002](./errors-and-warnings/NU1002.md), [NU1003](./errors-and-warnings/NU1003.md), [NU1004](./errors-and-warnings/NU1004.md), [NU1005](./errors-and-warnings/NU1005.md), [NU1006](./errors-and-warnings/NU1006.md), [NU1007](./errors-and-warnings/NU1007.md), [NU1008](./errors-and-warnings/NU1008.md), [NU1009](./errors-and-warnings/NU1009.md), [NU1010](./errors-and-warnings/NU1010.md), [NU1011](./errors-and-warnings/NU1011.md), [NU1012](./errors-and-warnings/NU1012.md), [NU1013](./errors-and-warnings/NU1013.md), [NU1014](./errors-and-warnings/NU1014.md), [NU1015](./errors-and-warnings/NU1015.md), [NU1016](./errors-and-warnings/NU1016.md), [NU1017](./errors-and-warnings/NU1017.md), [NU1019](./errors-and-warnings/NU1019.md) |
3131
| Missing package and project errors | [NU1100](./errors-and-warnings/NU1100.md), [NU1101](./errors-and-warnings/NU1101.md), [NU1102](./errors-and-warnings/NU1102.md), [NU1103](./errors-and-warnings/NU1103.md), [NU1104](./errors-and-warnings/NU1104.md), [NU1105](./errors-and-warnings/NU1105.md), [NU1106](./errors-and-warnings/NU1106.md), [NU1107](./errors-and-warnings/NU1107.md), [NU1108](./errors-and-warnings/NU1108.md), [NU1109](./errors-and-warnings/NU1109.md) |
3232
| Package source mapping errors | [NU1110](./errors-and-warnings/NU1110.md) |
3333
| Compatibility errors | [NU1201](./errors-and-warnings/NU1201.md), [NU1202](./errors-and-warnings/NU1202.md), [NU1203](./errors-and-warnings/NU1203.md), [NU1204](./errors-and-warnings/NU1204.md), [NU1401](./errors-and-warnings/NU1401.md), [NU1402](./errors-and-warnings/NU1402.md), [NU1403](./errors-and-warnings/NU1403.md) |
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: NuGet Error NU1019
3+
description: NU1019 error code
4+
author: nkolev92
5+
ms.author: nikolev
6+
ms.date: 04/02/2026
7+
ms.topic: reference
8+
f1_keywords:
9+
- "NU1019"
10+
---
11+
12+
# NuGet Error NU1019
13+
14+
## Scenario
15+
16+
> The project 'MyProject' contains a TargetFramework 'net10.0/win' with disallowed characters. TargetFramework names must contain only ASCII characters and must not contain path separators.
17+
18+
### Issue
19+
20+
Your project file has a `TargetFramework` or `TargetFrameworks` value that contains disallowed characters.
21+
NuGet doesn't allow the following characters in target framework names:
22+
23+
- **Path separators** (`/` or `\`): These characters break the assets file format and are always disallowed.
24+
- **Non-ASCII characters**: Target framework names must contain only ASCII characters (characters with a value of 127 or less).
25+
26+
This validation is gated behind the `SdkAnalysisLevel` property:
27+
28+
- **SDK analysis level 10.0.300 or later**: Path separators in target framework names raise an error.
29+
Non-ASCII characters raise a warning.
30+
- **SDK analysis level 11.0.100 or later**: Both path separators and non-ASCII characters raise an error.
31+
32+
### Solution
33+
34+
Rename the target framework values in your project file to use only ASCII characters and remove any path separators.
35+
36+
For example, change:
37+
38+
```xml
39+
<PropertyGroup>
40+
<TargetFramework>net10.0/win</TargetFramework>
41+
</PropertyGroup>
42+
```
43+
44+
To a valid target framework name:
45+
46+
```xml
47+
<PropertyGroup>
48+
<TargetFramework>net10.0-windows</TargetFramework>
49+
</PropertyGroup>
50+
```

0 commit comments

Comments
 (0)