Azure Storage-Clientbibliotheken für .NET

Die Azure Storage-Clientbibliotheken für .NET bieten eine praktische Schnittstelle zum Aufrufen von Azure Storage. Weitere Informationen zu Azure Storage finden Sie unter Einführung in Azure Storage.

Bibliotheken für den Datenzugriff

Die neueste Version der Azure Storage-Clientbibliothek für den Datenzugriff ist Version 12.x.x. Microsoft empfiehlt die Verwendung von Version 12.x.x für neue Anwendungen.

Wenn Sie vorhandene Anwendungen nicht auf Version 12.x.x aktualisieren können, empfiehlt Microsoft die Verwendung von Version 11.x.x.

Version 12.x.x

Die Clientbibliotheken der Version 12.x.x für .NET sind Teil des Azure SDK für .NET. Der Quellcode für die Azure Storage-Clientbibliotheken für .NET ist auf GitHub verfügbar.

Verwenden Sie die folgenden Bibliotheken der Version 12.x.x, um mit Blobs, Dateien und Warteschlangen zu arbeiten:

Bibliothek Verweis Paket `Source`
Azure.Storage.Blobs.Batch NuGet GitHub
Azure.Storage.Blobs Referenz NuGet GitHub
Azure.Storage.Common NuGet GitHub
Azure.Storage.Files.DataLake Referenz NuGet GitHub
Azure.Storage.Files.Shares Referenz NuGet GitHub
Azure.Storage.Queues Referenz NuGet GitHub

Version 11.x.x

Der Quellcode für die Azure Storage-Clientbibliotheken für .NET ist auf GitHub verfügbar.

Verwenden Sie die folgenden Bibliotheken der Version 11.x.x, um mit Blobs, Dateien und Warteschlangen zu arbeiten:

Bibliothek Verweis Paket `Source`
Microsoft.Azure.Storage.Blob Referenz NuGet GitHub
Microsoft.Azure.Storage.Common NuGet GitHub
Microsoft.Azure.Storage.File Referenz NuGet GitHub
Microsoft.Azure.Storage.Queue Referenz NuGet GitHub

Bibliotheken für die Ressourcenverwaltung

Die neueste Version der Azure Storage-Clientbibliothek für die Ressourcenverwaltung ist Version 1.x.x. Microsoft empfiehlt die Verwendung von Version 1.x.x für neue Anwendungen.

Wenn Sie vorhandene Anwendungen nicht auf Version 1.x.x aktualisieren können, empfiehlt Microsoft die Verwendung von Version 25.x.x.

Version 1.x.x

Verwenden Sie die folgende Version 1.x.x-Bibliothek, um mit dem Azure Storage-Ressourcenanbieter zu arbeiten:

Bibliothek Verweis Paket `Source`
Azure.ResourceManager.Storage Referenz NuGet GitHub

Version 25.x.x

Verwenden Sie die folgende Version 25.x.x-Bibliothek, um mit dem Azure Storage-Ressourcenanbieter zu arbeiten:

Bibliothek Verweis Paket `Source`
Microsoft.Azure.Management.Storage Referenz NuGet GitHub

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme für die Azure Storage-Clientbibliotheken für .NET beschrieben.

InvalidHeaderValue-Fehlermeldung bei Verwendung der Betaversion des SDK

In seltenen Szenarien können Anwendungen, die ein Upgrade auf die neueste Betaversion oder die allgemein verfügbare Version des SDK durchgeführt haben, eine InvalidHeaderValue Fehlermeldung erhalten. Dieses Problem kann auftreten, wenn Eine der Speicherbibliotheken verwendet wird. Die Fehlermeldung sieht in etwa wie im folgenden Beispiel aus:

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error> 

Wenn Sie ein Upgrade auf die neueste Betaversion oder allgemein verfügbare Version des SDK durchgeführt haben und dieser Fehler auftritt, wird empfohlen, ein Downgrade auf die vorherige allgemein verfügbare Version des SDK durchzuführen, um festzustellen, ob das Problem behoben wird. Wenn das Problem weiterhin besteht oder die Empfehlung nicht möglich ist, öffnen Sie ein Supportticket , um weitere Optionen zu erkunden.