dotnet ny <MALL>

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Name

dotnet new – Skapar ett nytt projekt, en konfigurationsfil eller en lösning baserat på den angivna mallen.

Sammanfattning

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [-f|--framework <FRAMEWORK>] [--no-update-check]
    [-o|--output <OUTPUT_DIRECTORY>] [--project <PROJECT_PATH>]
    [-d|--diagnostics] [--verbosity <LEVEL>] [Template options]

dotnet new -h|--help

beskrivning

Kommandot dotnet new skapar ett .NET-projekt eller andra artefakter baserat på en mall.

Kommandot anropar mallmotorn för att skapa artefakterna på disken baserat på den angivna mallen och alternativen.

Tabbavslut

Från och med .NET SDK 7.0.100 är tabbslutningen tillgänglig för dotnet new. Det stöder slutförande för installerade mallnamn, samt slutförande av de alternativ som en vald mall innehåller. Information om hur du aktiverar flikslutsättning för .NET SDK finns i Aktivera flikslutsättning.

Implicit återställning

Du behöver inte köra dotnet restore eftersom den körs implicit av alla kommandon som kräver en återställning, till exempel dotnet new, dotnet build, dotnet run, dotnet test, dotnet publishoch dotnet pack. Om du vill inaktivera implicit återställning använder du alternativet --no-restore .

Kommandot dotnet restore är fortfarande användbart i vissa scenarier där det är meningsfullt att uttryckligen återställa, till exempel kontinuerliga integreringsversioner i Azure DevOps Services eller i byggsystem som uttryckligen behöver styra när återställningen sker.

Information om hur du hanterar NuGet-feeds finns i dokumentationendotnet restore.

Argument

• TEMPLATE

  Mallen som instansierar när kommandot anropas. Varje mall kan ha specifika alternativ som du kan skicka. Mer information finns i Mallalternativ.

  Du kan köra dotnet new list för att se en lista över alla installerade mallar.

  Kommandotsearch ska användas för att söka efter mallar i NuGet.org.

  En lista över mallar som levereras med .NET SDK finns i Förinstallerade mallar.

Alternativ

• --dry-run

  Visar en sammanfattning av vad som skulle hända om det angivna kommandot kördes om det skulle resultera i att en mall skapades.

• --force

  Tvingar innehåll att genereras även om det skulle ändra befintliga filer. Detta krävs när den valda mallen skulle åsidosätta befintliga filer i utdatakatalogen.

• -?|-h|--help

  Skriver ut hjälp för kommandot. Det kan anropas för dotnet new själva kommandot eller för valfri mall. Exempel: dotnet new mvc --help

• -lang|--language {C#|F#|VB}

  Språket i mallen som ska skapas. Det språk som accepteras varierar beroende på mallen (se standardvärden i avsnittet argument ). Ogiltigt för vissa mallar.

  Kommentar

  Vissa gränssnitt tolkas # som ett specialtecken. I dessa fall omger du värdet för språkparametern inom citattecken. Exempel: dotnet new console -lang "F#"

• -n|--name <OUTPUT_NAME>

  Namnet på de skapade utdata. Om inget namn anges används namnet på den aktuella katalogen.

• -f|--framework <FRAMEWORK>

  Anger målramverket. Den förväntar sig en målramverksmoniker (TFM). Exempel: "net6.0", "net7.0-macos". Det här värdet återspeglas i projektfilen.

• -no-update-check

  Inaktiverar sökning efter mallpaketuppdateringar när du instansierar en mall. Tillgänglig sedan .NET SDK 6.0.100. När du instansierar mallen från ett mallpaket som installerades med hjälp dotnet new --installav kontrollerar dotnet new du om det finns en uppdatering för mallen. Från och med .NET 6 görs inga uppdateringskontroller för .NET-standardmallar. Om du vill uppdatera .NET-standardmallar installerar du korrigeringsversionen av .NET SDK.

• -o|--output <OUTPUT_DIRECTORY>

  Plats för att placera de genererade utdata. Standardvärdet är den aktuella katalogen.

• --project <PROJECT_PATH>

  Det projekt som mallen läggs till i. Det här projektet används för kontextutvärdering. Om det inte anges används projektet i de aktuella eller överordnade katalogerna. Tillgänglig sedan .NET SDK 7.0.100.

• -d|--diagnostics

  Aktiverar diagnostiska utdata. Tillgänglig sedan .NET SDK 7.0.100.

• -v|--verbosity <LEVEL>

  Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal]och diag[nostic]. Tillgänglig sedan .NET SDK 7.0.100.

Mallalternativ

Varje mall kan ha ytterligare alternativ definierade. Mer information finns i .NET-standardmallar för dotnet new.

Exempel

• Skapa ett C#-konsolprogramprojekt:

  dotnet new console
  

• Skapa ett F#-konsolprogramprojekt i den aktuella katalogen:

  dotnet new console --language "F#"
  

• Skapa ett klassbiblioteksprojekt för .NET Standard 2.0 i den angivna katalogen:

  dotnet new classlib --framework "netstandard2.0" -o MyLibrary
  

• Skapa ett nytt ASP.NET Core C# MVC-projekt i den aktuella katalogen utan autentisering:

  dotnet new mvc -au None
  

• Skapa ett nytt xUnit-projekt:

  dotnet new xunit
  

• Skapa en global.json i den aktuella katalogen som anger SDK-versionen till 8.0.101:

  dotnet new globaljson --sdk-version 8.0.101 --roll-forward latestFeature
  

• Visa hjälp för C#-konsolens programmall:

  dotnet new console -h
  

• Visa hjälp för F#-konsolprogrammallen:

  dotnet new console --language "F#" -h
  

Se även

• dotnet new list command
• dotnet new search command (dotnet new search command)
• dotnet new install command
• .NET-standardmallar för dotnet new
• Anpassade mallar för dotnet new
• Skapa en anpassad mall för dotnet new