dotnet-lijstpakket

Artikel
04/06/2024

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

Naam

dotnet list package - Geeft een overzicht van de pakketverwijzingen voor een project of oplossing.

Samenvatting

dotnet list [<PROJECT>|<SOLUTION>] package [--config <SOURCE>]
    [--deprecated]
    [-f|--framework <FRAMEWORK>] [--highest-minor] [--highest-patch]
    [--include-prerelease] [--include-transitive] [--interactive]
    [--outdated] [--source <SOURCE>] [-v|--verbosity <LEVEL>]
    [--vulnerable]
    [--format <console|json>]
    [--output-version <VERSION>]

dotnet list package -h|--help

Beschrijving

De dotnet list package opdracht biedt een handige optie om alle NuGet-pakketverwijzingen voor een specifiek project of een oplossing weer te geven. U moet eerst het project bouwen om de assets te hebben die nodig zijn om deze opdracht te kunnen verwerken. In het volgende voorbeeld ziet u de uitvoer van de dotnet list package opdracht voor het SentimentAnalysis-project :

Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

De kolom Aangevraagd verwijst naar de pakketversie die is opgegeven in het projectbestand en kan een bereik zijn. De kolom Opgelost bevat de versie die het project momenteel gebruikt en is altijd één waarde. De pakketten die naast hun namen worden (A) weergegeven, vertegenwoordigen impliciete pakketverwijzingen die zijn afgeleid van uw projectinstellingen (Sdk type of <TargetFramework><TargetFrameworks> eigenschap).

Gebruik de --outdated optie om erachter te komen of er nieuwere versies beschikbaar zijn van de pakketten die u in uw projecten gebruikt. --outdated Standaard worden de meest recente stabiele pakketten weergegeven, tenzij de opgeloste versie ook een voorlopige versie is. Als u voorlopige versies wilt opnemen bij het weergeven van nieuwere versies, geeft u ook de --include-prerelease optie op. Als u een pakket wilt bijwerken naar de nieuwste versie, gebruikt u dotnet add package.

In het volgende voorbeeld ziet u de uitvoer van de dotnet list package --outdated --include-prerelease opdracht voor hetzelfde project als in het vorige voorbeeld:

The following sources were used:
   https://api.nuget.org/v3/index.json
   C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\

Project `SentimentAnalysis` has the following updates to its packages
   [netcoreapp2.1]:
   Top-level Package      Requested   Resolved   Latest
   > Microsoft.ML         1.4.0       1.4.0      1.5.0-preview

Als u wilt weten of uw project transitieve afhankelijkheden heeft, gebruikt u de --include-transitive optie. Transitieve afhankelijkheden treden op wanneer u een pakket toevoegt aan uw project dat op zijn beurt afhankelijk is van een ander pakket. In het volgende voorbeeld ziet u de uitvoer van het uitvoeren van de dotnet list package --include-transitive opdracht voor het HelloPlugin-project , waarin pakketten op het hoogste niveau en de pakketten worden weergegeven waarvan ze afhankelijk zijn:

Project 'HelloPlugin' has the following package references
   [netcoreapp3.0]:
   Transitive Package      Resolved
   > PluginBase            1.0.0

Argumenten

PROJECT | SOLUTION

Het project- of oplossingsbestand waarop moet worden gewerkt. Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een map. Als er meer dan één oplossing of project wordt gevonden, wordt er een fout gegenereerd.

Opties

--config <SOURCE>

De NuGet-bronnen die moeten worden gebruikt bij het zoeken naar nieuwere pakketten. Hiervoor is de --outdated optie vereist.
--deprecated

Geeft pakketten weer die zijn afgeschaft.
-f|--framework <FRAMEWORK>

Geeft alleen de pakketten weer die van toepassing zijn op het opgegeven doelframework. Als u meerdere frameworks wilt opgeven, herhaalt u de optie meerdere keren. Voorbeeld: --framework net6.0 --framework netstandard2.0. De korte vorm van de optie (-f) is beschikbaar vanaf .NET 9 SDK.

-?|-h|--help

Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

--highest-minor

Houdt alleen rekening met de pakketten met een overeenkomend versienummer bij het zoeken naar nieuwere pakketten. Hiervoor is de --outdated of --deprecated optie vereist.
--highest-patch

Houdt alleen rekening met de pakketten met een overeenkomende primaire en secundaire versienummers bij het zoeken naar nieuwere pakketten. Hiervoor is de --outdated of --deprecated optie vereist.
--include-prerelease

Houdt rekening met pakketten met voorlopige versies bij het zoeken naar nieuwere pakketten. Hiervoor is de --outdated of --deprecated optie vereist.
--include-transitive

Bevat transitieve pakketten, naast de pakketten op het hoogste niveau. Wanneer u deze optie opgeeft, krijgt u een lijst met pakketten waarvan de pakketten op het hoogste niveau afhankelijk zijn.

--interactive

Hiermee kan de opdracht stoppen en wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien. Beschikbaar sinds .NET Core 3.0 SDK.

--outdated

Bevat pakketten met nieuwere versies.
-s|--source <SOURCE>

De NuGet-bronnen die moeten worden gebruikt bij het zoeken naar nieuwere pakketten. Hiervoor is de --outdated of --deprecated optie vereist.

-v|--verbosity <LEVEL>

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

--vulnerable

Bevat pakketten met bekende beveiligingsproblemen. Kan niet worden gecombineerd met --deprecated of --outdated opties. Nuget.org is de bron van informatie over beveiligingsproblemen. Zie Beveiligingsproblemen en NuGet-pakketten scannen op beveiligingsproblemen voor meer informatie.
--format <console|json>

Hiermee stelt u de indeling van de rapportuitvoer in. Toegestane waarden zijn console, json. Standaard ingesteld op console. Beschikbaar vanaf .NET SDK 7.0.200.
--output-version <VERSION>

Hiermee stelt u de uitvoerversie van het rapport in. Toegestane waarde is 1. Standaard ingesteld op 1. Hiervoor is de --format json optie vereist. Wanneer er een nieuwe JSON-versie beschikbaar is, produceert de opdracht standaard de nieuwe indeling. Met deze optie kunt u opgeven dat de opdracht een eerdere indeling moet produceren. Beschikbaar vanaf .NET SDK 7.0.200.

Voorbeelden

Pakketverwijzingen van een specifiek project weergeven:
```
dotnet list SentimentAnalysis.csproj package
```
Lijst met pakketverwijzingen met nieuwere versies, waaronder voorlopige versies:
```
dotnet list package --outdated --include-prerelease
```
Lijst met pakketverwijzingen voor een specifiek doelframework:
```
dotnet list package --framework netcoreapp3.0
```
Lijst met pakketverwijzingen in de leesbare JSON-uitvoerindeling van de machine:
```
dotnet list package --format json
```
Lijst met pakketverwijzingen voor een specifiek doelframework in de leesbare JSON-uitvoerindeling van de machine:
```
dotnet list package --framework netcoreapp3.0 --format json
```
Sla de leesbare JSON-uitvoer van pakketverwijzingen op, inclusief transitieve afhankelijkheid en details van beveiligingsproblemen in een bestand:
```
dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
```
Lijst met pakketverwijzingen in de leesbare JSON-uitvoerindeling met uitvoerversie 1:
```
dotnet list package --format json --output-version 1
```

Delen via