Bibliotecas de clientes do .NET

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

As bibliotecas de cliente estão disponíveis para desenvolvedores do .NET que criam aplicativos e serviços do Windows que se integram ao Azure DevOps. As bibliotecas de cliente se integram ao rastreamento de itens de trabalho, controle de versão, construção e outros serviços. Esses pacotes facilitam a aquisição e redistribuição das bibliotecas necessárias para seu aplicativo ou serviço.

Diagrama de dependência

Recursos das bibliotecas cliente do .NET

As bibliotecas de clientes do .NET para o Azure DevOps oferecem vários recursos importantes que facilitam a integração com serviços no Azure DevOps de seus aplicativos e serviços do Windows:

• Disponível para download em NuGet.org: importe facilmente as bibliotecas nos seus projetos do Visual Studio baixando-as de NuGet.org.
• Licenciado para redistribuição: as bibliotecas são licenciadas para redistribuição em seus aplicativos e serviços. Você pode exibir a licença para obter mais detalhes.
• Acesso a APIs: obtenha acesso às APIs tradicionais do modelo de objeto cliente e APIs REST, para interagir com o Azure DevOps programaticamente.
• Suporte a desafios de declarações: a partir da versão 20.259.0, as bibliotecas de clientes do .NET agora podem retornar tokens com desafios de declarações que podem ser usados para lidar normalmente com solicitações de reautenticação após eventos críticos da empresa (por exemplo, redefinições de senha, exclusões de conta etc.) como parte de nosso suporte para Avaliação de Acesso Contínuo. Suporte a Python e Go será disponibilizado no segundo semestre de 2025.

Tabela de mapeamento de versão do Pacote e do Azure DevOps

A tabela a seguir mapeia as versões do pacote das bibliotecas de clientes do .NET para as versões correspondentes do Azure DevOps Server. Use esta tabela para determinar qual versão do pacote corresponde à sua versão do Azure DevOps.

Para as versões prévias mais recentes, consulte a galeria de pacotes NuGet .

Pacotes REST

A tabela a seguir lista as bibliotecas de clientes do .NET disponíveis para acessar vários serviços por meio de APIs REST públicas. Esses pacotes podem ser baixados de NuGet.org e fornecer os binários necessários para integração com o Azure DevOps.

Pacote de sabonete

A tabela a seguir lista as bibliotecas de clientes do .NET disponíveis para acessar vários serviços por meio de APIs SOAP. Esses pacotes podem ser baixados de NuGet.org e fornecer os binários necessários para integração com o Azure DevOps. Use esses pacotes somente quando as APIs REST não oferecerem a funcionalidade necessária, por exemplo, a criação de workspaces no TFVC.

Instalar

Instale a partir de um prompt de comando do gerenciador de pacotes do NuGet:

PM> Install-Package Microsoft.TeamFoundationServer.ExtendedClient

Conectar

Para criar uma conexão autenticada com o Azure DevOps, obtenha um HttpClient para o serviço que você quer usar e depois chame os métodos desse serviço.

Veja os seguintes exemplos:

using Microsoft.VisualStudio.Services.Common;
using Microsoft.VisualStudio.Services.Client;
using Microsoft.TeamFoundation.SourceControl.WebApi;
using Microsoft.VisualStudio.Services.WebApi;

const string collectionUri = "https://dev.azure.com/fabrikam";
const string projectName = "MyGreatProject";
const string repoName = "MyRepo";
const string accessToken = "your-microsoft-entra-id-token";

Uri orgUrl = new Uri(collectionUri);

// Connect to Azure DevOps using Microsoft Entra ID token
VssConnection connection = new VssConnection(orgUrl, new VssBasicCredential(string.Empty, accessToken));

// Get a GitHttpClient to talk to the Git endpoints
using (GitHttpClient gitClient = connection.GetClient<GitHttpClient>())
{
    // Get data about a specific repository
    var repo = gitClient.GetRepositoryAsync(projectName, repoName).Result;
}

Os métodos de autenticação que produzem um diálogo interativo não estão disponíveis na versão .NET Standard das bibliotecas cliente do .NET. Quando você estiver usando a versão do .NET Standard, forneça suas credenciais de forma mais explícita para autenticar, como no exemplo a seguir.

using System;
using Microsoft.TeamFoundation.SourceControl.WebApi;
using Microsoft.VisualStudio.Services.Common;
using Microsoft.VisualStudio.Services.WebApi;

namespace ConsoleApp1
{
    class Program
    {
        const string collectionUri = "https://dev.azure.com/fabrikam";
        const string projectName = "MyGreatProject";
        const string repoName = "MyRepo";
        const string accessToken = "your-microsoft-entra-id-token";

        static void Main(string[] args)
        {
            var creds = new VssBasicCredential(string.Empty, accessToken);
            
            // Connect to Azure DevOps Services using Microsoft Entra ID token
            var connection = new VssConnection(new Uri(collectionUri), creds);
            
            // Get a GitHttpClient to talk to the Git endpoints
            using var gitClient = connection.GetClient<GitHttpClient>();
            
            // Get data about a specific repository
            var repo = gitClient.GetRepositoryAsync(projectName, repoName).Result;
        }
    }
}

Para obter mais exemplos de autenticação, consulte os exemplos do .NET .

Referência

Para obter mais informações e ver documentação de referência atualizada, consulte o navegador de API do .NET.

Exemplos

Confira exemplos em nossa página de exemplos do .NET.

Para obter mais informações sobre pacotes NuGet, consulte Microsoft.VisualStudio.Services.Client.

Problemas conhecidos

A caixa de diálogo de autenticação interativa não aparece ao usar o Azure DevOps OM em um STA (Single Threaded Apartment)

A caixa de diálogo de autenticação interativa não aparece nos casos em que o código está em execução em um STA (Single Threaded Apartment). Esse problema geralmente pode ocorrer de aplicativos WPF. Para contornar esse problema, você pode alterar seu método de inicialização para ser assíncrono e solicitar autenticação como no exemplo a seguir.

async void InitAzureDevOps()
{
    Uri _uri = new Uri("https://dev.azure.com/MyAccount/");

    var creds = new VssClientCredentials(new WindowsCredential(false),
                                         new VssFederatedCredential(false),
                                         CredentialPromptType.PromptIfNeeded);

    VssConnection vssConnection = new VssConnection(_uri, creds);
    CancellationTokenSource source = new CancellationTokenSource();
    CancellationToken token = source.Token;
    await vssConnection.ConnectAsync(token);

    ...

}

Uso das versões do NET Standard 2.0 do Azure DevOps OM

Para a versão 16.143.1 de nossos pacotes NuGet, damos suporte ao NetStandard 2.0. Esses pacotes se correlacionam com o Servidor do Azure DevOps e são totalmente compatíveis com o Azure DevOps.

O pacote Microsoft.TeamFoundationServer.ExtendedClient não tem suporte para NetStandard

O Microsoft.TeamFoundationServer.ExtendedClient não dá suporte a uma versão compatível com o NetStandard.