dotnet schoon

Dit artikel is van toepassing op: ✔️ .NET 6 SDK en latere versies

Naam

dotnet clean - Schoont de uitvoer van een project op.

Samenvatting

dotnet clean [<PROJECT>|<SOLUTION>|<FILE>] [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--interactive]
    [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--tl:[auto|on|off]]
    [-v|--verbosity <LEVEL>]

dotnet clean -h|--help

Description

Met dotnet clean de opdracht wordt de uitvoer van de vorige build opgeschoond. Het wordt geïmplementeerd als een MSBuild-doel, dus het project wordt geëvalueerd wanneer de opdracht wordt uitgevoerd. Alleen de uitvoer die tijdens de build is gemaakt, worden opgeschoond. Zowel tussenliggende (obj) als uiteindelijke uitvoermappen (bin) worden opgeschoond.

Arguments

PROJECT | SOLUTION | FILE

Het project- of oplossings- of C#-bestand (op bestanden gebaseerde app) waarop moet worden gewerkt. Als er geen bestand is opgegeven, zoekt MSBuild in de huidige map naar een project of oplossing.

• PROJECT is het pad en de bestandsnaam van een C#-, F#- of Visual Basic-projectbestand, of het pad naar een map die een C#-, F#- of Visual Basic-projectbestand bevat.

• SOLUTION is het pad en de bestandsnaam van een oplossingsbestand (.sln of .slnx extensie) of het pad naar een map met een oplossingsbestand.

• FILE is een argument toegevoegd in .NET 10. Het pad en de bestandsnaam van een app op basis van bestanden. Apps op basis van bestanden bevinden zich in één bestand dat is gebouwd en uitgevoerd zonder een bijbehorend projectbestand (.csproj). Zie C#-apps bouwen op basis van bestanden voor meer informatie.

Options

• --artifacts-path <ARTIFACTS_DIR>

  Alle builduitvoerbestanden van de uitgevoerde opdracht worden weergegeven in submappen onder het opgegeven pad, gescheiden door project. Zie De indeling Artefacten-uitvoer voor meer informatie. Beschikbaar sinds .NET 8 SDK.

• -c|--configuration <CONFIGURATION>

  Definieert de buildconfiguratie. De standaardinstelling voor de meeste projecten is Debug, maar u kunt de buildconfiguratie-instellingen in uw project overschrijven. Deze optie is alleen vereist bij het schoonmaken als u deze tijdens de buildtijd hebt opgegeven.

• -f|--framework <FRAMEWORK>

  Het framework dat tijdens de build is opgegeven. Het framework moet worden gedefinieerd in het projectbestand. Als u het framework tijdens de build hebt opgegeven, moet u het framework opgeven tijdens het opschonen.

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

• --interactive

  Hiermee kan de opdracht stoppen en wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien.

• --nologo

  De opstartbanner of het copyrightbericht wordt niet weergegeven.

• -o|--output <OUTPUT_DIRECTORY>

  De map met de buildartefacten die moeten worden opgeschoond. Geef de -f|--framework <FRAMEWORK> switch op met de uitvoermapswitch als u het framework hebt opgegeven toen het project werd gebouwd.

  • .NET 7.0.200 SDK en hoger

    Als u de optie opgeeft bij het --output uitvoeren van deze opdracht op een oplossing, verzendt de CLI een waarschuwing (een fout in 7.0.200) vanwege de onduidelijke semantiek van het uitvoerpad. De --output optie is niet toegestaan omdat alle uitvoer van alle gemaakte projecten wordt gekopieerd naar de opgegeven map, die niet compatibel is met projecten met meerdere doelgroepen, evenals projecten met verschillende versies van directe en transitieve afhankelijkheden. Zie De optie Op oplossingsniveau --output is niet meer geldig voor build-gerelateerde opdrachten voor meer informatie.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Schoont de uitvoermap van de opgegeven runtime op. Dit wordt gebruikt wanneer een zelfstandige implementatie is gemaakt.

• --tl:[auto|on|off]

  Hiermee geeft u op of Terminal Logger moet worden gebruikt voor de build-uitvoer. De standaardwaarde is auto, waarmee eerst de omgeving wordt geverifieerd voordat u terminallogboekregistratie inschakelt. De omgevingscontrole controleert of de terminal in staat is moderne uitvoerfuncties te gebruiken en geen omgeleide standaarduitvoer gebruikt voordat de nieuwe logger wordt ingeschakeld. on slaat de omgevingscontrole over en schakelt terminallogboekregistratie in. off slaat de omgevingscontrole over en maakt gebruik van de standaardconsolelogger.

  Terminal Logger toont de herstelfase, gevolgd door de buildfase. Tijdens elke fase worden de huidige bouwprojecten onderaan de terminal weergegeven. Elk project dat wordt gebouwd, levert zowel het MSBuild-doel dat momenteel wordt gebouwd als de hoeveelheid tijd die aan dat doel is besteed. U kunt deze informatie doorzoeken voor meer informatie over de build. Wanneer een project klaar is met bouwen, wordt één sectie 'build completed' geschreven die het volgende vastlegt:

  • De naam van het gebouwde project.
  • Het doelframework (indien multi-targeted).
  • De status van die build.
  • De primaire uitvoer van die build (die is hyperlinked).
  • Diagnostische gegevens die voor dat project worden gegenereerd.

  Deze optie is beschikbaar vanaf .NET 8.

• -v|--verbosity <LEVEL>

  Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is normal. Zie LoggerVerbosity voor meer informatie.

Voorbeelden

• Een standaardbuild van het project opschonen:

  dotnet clean
  

• Een op bestanden gebaseerd programma opschonen:

  dotnet clean Program.cs.
  

  Ondersteuning voor app op basis van bestanden is toegevoegd in .NET SDK 10.0.100.

• Een project opschonen dat is gebouwd met behulp van de releaseconfiguratie:

  dotnet clean --configuration Release