Partilhar via


pesquisar pacotes do dotnet

Este artigo aplica-se a: ✔️ .NET 8.0.2xx SDK e versões posteriores

Nome

dotnet package search - Procura um pacote NuGet.

Sinopse

dotnet package search <SEARCH TERM> [--configfile <FILE>] [--exact-match] [--format <FORMAT OPTION>]
    [--interactive] [--prerelease] [--skip <NUMBER>] [--source <SOURCE>] [--take <NUMBER>]
    [--verbosity <VERBOSITY VALUE>]

dotnet package search -h|--help

Description

O dotnet package search comando procura um pacote NuGet.

Arguments

  • search terms

    Especifica o termo de pesquisa para filtrar resultados. Use este argumento para procurar pacotes que correspondam à consulta fornecida. Exemplo: dotnet package search json.

Opções

  • --configfile <FILE>

    O arquivo de configuração do NuGet (nuget.config) a ser usado. Se especificado, somente as configurações desse arquivo serão usadas. Se não for especificado, a hierarquia de arquivos de configuração do diretório atual será usada. Para obter mais informações, consulte Configurações comuns do NuGet.

  • --exact-match

    Esta opção restringe a pesquisa para incluir apenas pacotes cujos IDs correspondam exatamente ao termo de pesquisa especificado, filtrando efetivamente quaisquer correspondências parciais. Fornece uma lista concisa de todas as versões disponíveis para o pacote identificado. Causas --take e --skip opções a ignorar. Utilize esta opção para mostrar todas as versões disponíveis de um pacote especificado.

  • --format

    As opções de formato são table e json. A predefinição é table.

  • --interactive

    Permite que o comando pare e aguarde a entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

  • --prerelease

    Permitir que os pacotes de pré-lançamento sejam mostrados.

  • --skip

    O número de resultados a ignorar, para paginação. O valor padrão é 0.

  • --source <SOURCE>

    A fonte do pacote para pesquisar. Pode passar várias opções de --source para pesquisar várias fontes de pacotes.

  • --take

    O número de resultados a retornar. O valor padrão é 20.

  • -v|--verbosity <LEVEL>

    Define o nível de verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic]. Para obter mais informações, consulte LoggerVerbosity.

  • -?|-h|--help

    Imprime uma descrição de como usar o comando.

Examples

  • Pesquise NuGet.org pacotes que correspondam ao termo de pesquisa "Newtonsoft.Json" e renderize a saída como uma tabela com até 20 pacotes:

    dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json
    
        Source: https://api.nuget.org/v3/index.json
        | Package ID                                  | Latest Version | Owners | Downloads       |
        |---------------------------------------------|----------------|--------|-----------------|
        | Newtonsoft.Json                             | 13.0.3         |        | 3,829,822,911   |
        |---------------------------------------------|----------------|--------|-----------------|
        | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
        |---------------------------------------------|----------------|--------|-----------------|
        | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
        |---------------------------------------------|----------------|--------|-----------------|
        | Microsoft.AspNetCore.Mvc.NewtonsoftJson     | 7.0.12         |        | 317,067,823     |
        |---------------------------------------------|----------------|--------|-----------------|
        ...
    
  • Pesquise NuGet.org pacotes que correspondam ao termo de pesquisa "Newtonsoft.Json" e renderize a saída como json.

    dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --format json
    
        {
        "version": 2,
        "problems": [],
        "searchResult": [
            {
            "sourceName": "https://api.nuget.org/v3/index.json",
            "packages": [
                {
                "id": "Newtonsoft.Json",
                "latestVersion": "13.0.3",
                "totalDownloads": 4456137550,
                "owners": "dotnetfoundation, jamesnk, newtonsoft"
                },
                {
                "id": "Newtonsoft.Json.Bson",
                "latestVersion": "1.0.2",
                "totalDownloads": 655362732,
                "owners": "dotnetfoundation, jamesnk, newtonsoft"
                },
                {
                "id": "Newtonsoft.Json.Schema",
                "latestVersion": "3.0.15",
                "totalDownloads": 46062119,
                "owners": "jamesnk, newtonsoft"
                },
                {
                "id": "Microsoft.AspNetCore.Mvc.NewtonsoftJson",
                "latestVersion": "8.0.3",
                "totalDownloads": 372202749,
                "owners": "aspnet, dotnetframework, Microsoft"
                },
                {
                "id": "Newtonsoft.Json.Encryption",
                "latestVersion": "2.2.0",
                "totalDownloads": 113101,
                "owners": "simoncropp"
                }
            ]
            }
        ]
        }
    
  • Pesquisar NuGet.org pacotes que usem o termo de pesquisa "Newtonsoft.Json", mostrar apenas dois resultados e saltar os primeiros pacotes no resultado de pesquisa:

    dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --skip 1 --take 2
    
        Source: https://api.nuget.org/v3/index.json
        | Package ID                                  | Latest Version | Owners | Downloads       |
        |---------------------------------------------|----------------|--------|-----------------|
        | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
        | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
    
  • Procure pacotes que correspondam exatamente a "Newtonsoft.Json" e liste todas as versões disponíveis, ignorando quaisquer pacotes que contenham "Newtonsoft.Json" como parte do nome ou descrição mas que não correspondam exatamente:

    dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --exact-match
    
        Source: https://api.nuget.org/v3/index.json
        | Package ID                                  | Version | Owners | Downloads       |
        |---------------------------------------------|---------|--------|-----------------|
        | Newtonsoft.Json                             | 13.0.3  |        | 3,829,822,911   |