IFileSystemOperations.DownloadFile Methode

Definition

Namespace:

Microsoft.Azure.Management.DataLake.Store

Assembly:

Microsoft.Azure.Management.DataLake.Store.dll

Paket:

Microsoft.Azure.Management.DataLake.Store v2.2.1

Lädt eine Datei aus dem angegebenen Data Lake Store-Konto herunter.

public void DownloadFile (string accountName, string sourcePath, string destinationPath, int threadCount = -1, bool resume = false, bool overwrite = false, IProgress<Microsoft.Azure.Management.DataLake.Store.TransferProgress> progressTracker = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadFile : string * string * string * int * bool * bool * IProgress<Microsoft.Azure.Management.DataLake.Store.TransferProgress> * System.Threading.CancellationToken -> unit

Public Sub DownloadFile (accountName As String, sourcePath As String, destinationPath As String, Optional threadCount As Integer = -1, Optional resume As Boolean = false, Optional overwrite As Boolean = false, Optional progressTracker As IProgress(Of TransferProgress) = Nothing, Optional cancellationToken As CancellationToken = Nothing)

Parameter

accountName

String

Das Azure Data Lake Store-Konto zum Ausführen von Dateisystemvorgängen.

sourcePath

String

Der Data Lake Store-Pfad (beginnend mit "/") der herunterzuladenden Datei.

destinationPath

String

Der lokale Pfad, in den die Datei heruntergeladen werden soll. Wenn ein Verzeichnis angegeben wird, entspricht der Dateiname dem Namen der Quelldatei.

threadCount

Int32

Die maximale Anzahl von Threads, die während des Downloads verwendet werden sollen. Standardmäßig wird diese Zahl basierend auf der Dateigröße berechnet.

resume

Boolean

Ein Schalter, der angibt, ob dieser Download eine Fortsetzung eines vorherigen, fehlgeschlagenen Downloads ist. Der Standardwert ist "false".

overwrite

Boolean

Ein Schalter, der diesen Download angibt, sollte die Zieldatei überschreiben, sofern vorhanden. Der Standardwert ist false, und der Download schlägt schnell fehl, wenn die Zieldatei vorhanden ist.

progressTracker

IProgress<TransferProgress>

Ein optionaler Delegat, der verwendet werden kann, um den Fortschritt des Downloadvorgangs asynchron nachzuverfolgen.

cancellationToken

CancellationToken

Das Abbruchtoken.

Ausnahmen

AdlsErrorException

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

TaskCanceledException

Wird ausgelöst, wenn der Vorgang zu lange dauert oder der Benutzer ihn explizit abbricht.

InvalidMetadataException

Wird ausgelöst, wenn die Metadaten des Fortsetzens beschädigt sind oder dem aktuellen Vorgang nicht zugeordnet sind.

FileNotFoundException

Wird ausgelöst, wenn der Quellpfad nicht gefunden werden kann.

InvalidOperationException

Wird ausgelöst, wenn während des Vorgangs ein ungültiger Download versucht oder eine Datei extern geändert wird.

Microsoft.Azure.Management.DataLake.Store.TransferFailedException

Wird ausgelöst, wenn der Übertragungsvorgang fehlschlägt.

SerializationException

Wird ausgelöst, wenn die Antwort nicht deserialisiert werden kann

ValidationException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist