IFileSystemOperations.AppendWithHttpMessagesAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
Décalage facultatif dans le flux pour commencer l’opération d’ajout. La valeur par défaut consiste à ajouter à la fin du flux.
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 »
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.
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 à
Azure SDK for .NET