global.json
ASP.NET global configuration file
global.json
Validate
Check your file against this schema
Opens the validator with this schema already loaded. Paste your
global.json and it validates in your browser — nothing is uploaded.
Reference
Fields
Generated directly from the schema, following local
$refs, to two levels of nesting.
| Field | Type | Description |
|---|---|---|
sdk | object | Specifies information about the .NET SDK to select. https://learn.microsoft.com/dotnet/core/tools/global-json#sdk |
sdk.version | string | The version of the .NET SDK to use. A full version number is required; wildcards and version ranges aren't supported. https://learn.microsoft.com/dotnet/core/tools/global-json#version |
sdk.allowPrerelease | boolean | Whether the SDK resolver should consider prerelease versions when selecting the SDK version to use. https://learn.microsoft.com/dotnet/core/tools/global-json#allowprerelease |
sdk.rollForward | string | The roll-forward policy to use when selecting an SDK version. A version must also be specified unless this is set to 'latestMajor'. When omitted, the effective policy is 'patch' if a version is specified and 'latestMajor' otherwise one of: "patch", "feature", "minor", "major", "latestPatch", "latestFeature" … (+3) |
sdk.paths | array<string> | The locations to consider when searching for a compatible .NET SDK. Paths can be absolute, relative to global.json, or the special value '$host$'. Available since .NET 10 SDK. https://learn.microsoft.com/dotnet/core/tools/global-json#paths |
sdk.errorMessage | string | A custom error message to display when the SDK resolver can't find a compatible .NET SDK. Available since .NET 10 SDK. https://learn.microsoft.com/dotnet/core/tools/global-json#errormessage |
msbuild-sdks | object | Controls project SDK versions in one place rather than in each individual project. Each property name is a project SDK name and its value is the version to use. https://learn.microsoft.com/dotnet/core/tools/global-json#msbuild-sdks |
test | object | Specifies information about tests. https://learn.microsoft.com/dotnet/core/tools/global-json#test |
test.runner | string | The test runner that the 'dotnet test' command uses to discover and run tests. Available since .NET 10 SDK. https://learn.microsoft.com/dotnet/core/tools/global-json#runner default: "VSTest"one of: "Microsoft.Testing…, "VSTest" |
Audit
What we found in this schema
- Declared draft: draft-07
- Validates cleanly against its own meta-schema.
- 11 properties, 82% carrying a description, max nesting depth 8.
Standards
Specification sections for the keywords in this schema
| Keyword | Document | Section |
|---|---|---|
$id | JSON Schema Core, draft 2020-12 | §8.2.1 — The "$id" Keyword |
$schema | JSON Schema Core, draft 2020-12 | §8.1.1 — "$schema" |
additionalProperties | JSON Schema Core, draft 2020-12 | §10.3.2.3 — "additionalProperties" |
anyOf | JSON Schema Core, draft 2020-12 | §10.2.1.2 — "anyOf" |
default | JSON Schema Validation, draft 2020-12 | §9.2 — "default" |
description | JSON Schema Validation, draft 2020-12 | §9.1 — "title" and "description" |
enum | JSON Schema Validation, draft 2020-12 | §6.1.2 — "enum" |
items | JSON Schema Core, draft 2020-12 | §10.3.1.2 — "items" |
pattern | JSON Schema Validation, draft 2020-12 | §6.3.3 — "pattern" |
properties | JSON Schema Core, draft 2020-12 | §10.3.2.1 — "properties" |
required | JSON Schema Validation, draft 2020-12 | §6.5.3 — "required" |
type | JSON Schema Validation, draft 2020-12 | §6.1.1 — "type" |
Documents
- JSON Schema Core, draft 2020-12 — JSON Schema: A Media Type for Describing JSON Documents, A. Wright, H. Andrews, B. Hutton, G. Dennis, Eds., 2022. draft-bhutton-json-schema-01. An expired Internet-Draft with no formal standing in the IETF standards process; it is nonetheless the specification of record for JSON Schema 2020-12, published by json-schema.org.
- JSON Schema Validation, draft 2020-12 — JSON Schema Validation: A Vocabulary for Structural Validation of JSON, A. Wright, H. Andrews, B. Hutton, Eds., 2022.
- RFC 8259 (STD 90) — The JavaScript Object Notation (JSON) Data Interchange Format, T. Bray, Ed., 2017. The format a schema describes.
- RFC 6901 — JavaScript Object Notation (JSON) Pointer. Defines the pointer syntax used by $ref fragments and the ~0 / ~1 escapes.
Source
Attribution
This schema comes from SchemaStore, distributed under the Apache License 2.0. Copyright 2015–present Mads Kristensen and contributors. View the original file. The field table and audit on this page are generated by JSONTools.tools; the schema itself is unmodified.