Partager via


IFileSystemOperations.AppendWithHttpMessagesAsync Méthode

Définition

Utilisé pour les ajouts en série au fichier spécifié. REMARQUE : La cible ne doit pas contenir de données ajoutées par ConcurrentAppend. ConcurrentAppend et Append ne peuvent pas être utilisés indifféremment ; une fois qu’un fichier cible a été modifié à l’aide de l’une de ces options d’ajout, l’autre option d’ajout ne peut pas être utilisée sur le fichier cible.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> AppendWithHttpMessagesAsync (string accountName, string directFilePath, System.IO.Stream streamContents, long? offset = default, Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag? syncFlag = default, Guid? leaseId = default, Guid? fileSessionId = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> AppendWithHttpMessagesAsync (string accountName, string path, System.IO.Stream streamContents, long? offset = default, Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag? syncFlag = default, Guid? leaseId = default, Guid? fileSessionId = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member AppendWithHttpMessagesAsync : string * string * System.IO.Stream * Nullable<int64> * Nullable<Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag> * Nullable<Guid> * Nullable<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
abstract member AppendWithHttpMessagesAsync : string * string * System.IO.Stream * Nullable<int64> * Nullable<Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag> * Nullable<Guid> * Nullable<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
Public Function AppendWithHttpMessagesAsync (accountName As String, directFilePath As String, streamContents As Stream, Optional offset As Nullable(Of Long) = Nothing, Optional syncFlag As Nullable(Of SyncFlag) = Nothing, Optional leaseId As Nullable(Of Guid) = Nothing, Optional fileSessionId As Nullable(Of Guid) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)
Public Function AppendWithHttpMessagesAsync (accountName As String, path As String, streamContents As Stream, Optional offset As Nullable(Of Long) = Nothing, Optional syncFlag As Nullable(Of SyncFlag) = Nothing, Optional leaseId As Nullable(Of Guid) = Nothing, Optional fileSessionId As Nullable(Of Guid) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)

Paramètres

accountName
String

Compte Azure Data Lake Store sur lequel exécuter des opérations de système de fichiers.

directFilePathpath
String

Chemin d’accès Data Lake Store (commençant par « / ») du fichier auquel ajouter.

streamContents
Stream

Contenu du fichier à inclure lors de l’ajout au fichier.

offset
Nullable<Int64>

Décalage facultatif dans le flux pour commencer l’opération d’ajout. La valeur par défaut consiste à ajouter à la fin du flux.

syncFlag
Nullable<SyncFlag>

Indique éventuellement ce qu’il faut faire une fois l’ajout simultané terminé. DATA indique que davantage de données seront envoyées immédiatement par le client, que le handle de fichier doit rester ouvert/verrouillé et que les métadonnées du fichier (y compris la longueur du fichier, l’heure de la dernière modification) ne doivent PAS être mises à jour. LES MÉTADONNÉES indiquent que davantage de données seront envoyées immédiatement par le client, que le handle de fichier doit rester ouvert/verrouillé et que les métadonnées du fichier doivent être mises à jour. CLOSE indique que le client a terminé d’envoyer des données, que le handle de fichier doit être fermé/déverrouillé et que les métadonnées du fichier doivent être mises à jour. Les valeurs possibles sont les suivantes : « DATA », « METADATA », « CLOSE »

leaseId
Nullable<Guid>

GUID unique facultatif par fichier pour garantir la sémantique d’un enregistreur unique, ce qui signifie que seuls les clients qui ajoutent au fichier avec le même leaseId seront autorisés à le faire.

fileSessionId
Nullable<Guid>

GUID unique facultatif par fichier indiquant que tous les ajouts avec le même fileSessionId proviennent du même client et de la même session. Cela offre un avantage en matière de performances lorsque syncFlag est DATA ou METADATA.

customHeaders
Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la demande.

cancellationToken
CancellationToken

Jeton d'annulation.

Retours

Exceptions

Levée lorsque l’opération a retourné un code status non valide

Levée lorsqu’un paramètre requis a la valeur Null

S’applique à