Compartilhar via


Busca de pacotes dotnet

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

Nome

dotnet package search - Pesquisa 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 pesquisa um pacote NuGet.

Arguments

  • search terms

    Especifica o termo de pesquisa para filtrar os resultados. Use esse argumento para pesquisar pacotes correspondentes à consulta fornecida. Exemplo: dotnet package search json.

Opções

  • --configfile <FILE>

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

  • --exact-match

    Essa opção restringe a pesquisa para incluir apenas pacotes cujas IDs correspondem exatamente ao termo de pesquisa especificado, filtrando efetivamente todas as correspondências parciais. Ele fornece uma lista concisa de todas as versões disponíveis para o pacote identificado. Causas --take e --skip opções a serem ignoradas. Utilize essa opção para exibir todas as versões disponíveis de um pacote especificado.

  • --format

    As opções de formato são table e json. O padrã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 pacotes de pré-lançamento sejam mostrados.

  • --skip

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

  • --source <SOURCE>

    A origem do pacote a ser pesquisada. Você pode passar várias opções de --origem para pesquisar várias fontes de pacote.

  • --take

    O número de resultados a serem retornados. 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.

Exemplos

  • 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"
                }
            ]
            }
        ]
        }
    
  • Pesquise NuGet.org pacotes usando o termo de pesquisa "Newtonsoft.Json", mostre apenas dois resultados e ignore os primeiros pacotes no resultado da 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      |
    
  • Pesquise pacotes que correspondam exatamente a "Newtonsoft.Json" e liste todas as versões disponíveis dele, ignorando todos os pacotes que contêm "Newtonsoft.Json" como parte de seu nome ou descrição, mas não correspondem exatamente a ele:

    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   |