.NET-Clientbibliotheken

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

Clientbibliotheken sind für .NET-Entwickler verfügbar, die Windows-Apps und -Dienste erstellen, die in Azure DevOps integriert sind. Clientbibliotheken sind in die Nachverfolgung von Arbeitsaufgaben, die Versionsverwaltung, den Build und andere Dienste integriert. Diese Pakete ersetzen das herkömmliche TFS-Client-OM-Installationsprogramm und machen es einfach, die bibliotheken zu erwerben und neu zu verteilen, die von Ihrer App oder Ihrem Dienst benötigt werden.

Abhängigkeitsdiagramm

Features

• Herunterladbar aus NuGet.org und einfach in Ihre Visual Studio-Projekte
• Bibliotheken werden für die Umverteilung in Ihren Apps und Diensten lizenziert (Anzeigen der Lizenz)
• Zugreifen auf herkömmliche Clientobjektmodell-APIs und REST-APIs

Paket- und Azure DevOps-Versionszuordnungstabelle

Die neuesten Vorschauversionen finden Sie im NuGet-Paketkatalog.

REST-Pakete

Soap-Paket

Installieren

Installieren von einer NuGet-Paket-Manager-Eingabeaufforderung:

PM> Install-Package Microsoft.TeamFoundationServer.ExtendedClient

Verbinden

Um eine authentifizierte Verbindung mit Azure DevOps zu erstellen, rufen Sie einen HttpClient für den Dienst ab, mit dem Sie arbeiten möchten, und rufen Sie dann Methoden für diesen Dienst auf.

Siehe folgende Beispiele:

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

const String c_collectionUri = "https://dev.azure.com/fabrikam";
const String c_projectName = "MyGreatProject";
const String c_repoName = "MyRepo";

Uri orgUrl = new Uri(c_collectionUri);

// Connect to Azure DevOps Services
VssConnection connection = new VssConnection(orgUrl, new VssBasicCredential(string.Empty, personalAccessToken));

// 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(c_projectName, c_repoName).Result;
}

Authentifizierungspfade, die ein interaktives Dialogfeld erzeugen, sind in der .NET Standard-Version der .NET-Clientbibliotheken nicht verfügbar. Wenn Sie die .NET Standard-Version verwenden, geben Sie Ihre Anmeldeinformationen expliziter für die Authentifizierung an, z. B. im folgenden Beispiel.

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 pat = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";

        static void Main(string[] args)
        {
            var creds = new VssBasicCredential(string.Empty, pat);
            
            // Connect to Azure DevOps Services
            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;
        }
    }
}

Weitere Authentifizierungsbeispiele finden Sie unter .NET-Beispiele.

Verweis

Weitere Informationen und aktuelle Referenzdokumentation finden Sie im .NET-API-Browser.

Beispiele

Schauen Sie sich Beispiele auf unserer .NET-Beispielseite oder direkt auf unserem .NET GitHub Repo an.

Bekannte Probleme

Das Dialogfeld "Interaktive Authentifizierung" wird nicht angezeigt, wenn Sie das Azure DevOps-OM in einem Single Threaded Apartment (STA) verwenden.

Das Dialogfeld für die interaktive Authentifizierung wird nicht in Fällen angezeigt, in denen Ihr Code aus einem Single Threaded Apartment (STA) ausgeführt wird. Dieses Problem kann häufig von WPF-Anwendungen auftreten. Um dieses Problem zu umgehen, können Sie die Initialisierungsmethode so ändern, dass sie asynchron ist und die Authentifizierung anfordert, wie im folgenden Beispiel gezeigt.

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);
    await vssConnection.ConnectAsync();

    ...

}

Verwenden von NetStandard 2.0-Versionen des Azure DevOps-OM

Für Version 16.143.1 unserer NuGet-Pakete unterstützen wir NetStandard 2.0. Diese Pakete korrelieren mit Azure DevOps Server 2019 RTW und sind vollständig mit Azure DevOps kompatibel.

Microsoft.TeamFoundationServer.ExtendedClient-Paket hat keine NetStandard-Unterstützung

Der Microsoft.TeamFoundationServer.ExtendedClient unterstützt keine netStandard-kompatible Version.