IRecordSequence.BeginAppend 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.
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone.
Surcharges
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone à l'aide de l'espace précédemment réservé dans la séquence. |
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone à l'aide de l'espace précédemment réservé dans la séquence. |
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone. |
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone à l'aide de l'espace précédemment réservé dans la séquence. |
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone à l'aide de l'espace précédemment réservé dans la séquence.
public:
IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousUndoRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAppend (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousUndoRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations, AsyncCallback callback, object state);
abstract member BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
Public Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousUndoRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult
Paramètres
- data
- IList<ArraySegment<Byte>>
Liste des segments de tableau d'octets qui seront concaténés et ajoutés en tant qu'enregistrement.
- nextUndoRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre spécifié par l'utilisateur.
- previousUndoRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre précédent.
- recordAppendOptions
- RecordAppendOptions
Une valeur valide de RecordAppendOptions qui spécifie comment les données doivent être écrites.
- reservations
- ReservationCollection
ReservationCollection qui contient la réservation qui doit être utilisée pour cet enregistrement.
- callback
- AsyncCallback
Rappel asynchrone facultatif à appeler lorsque l'ajout est terminé.
- state
- Object
Objet fourni par l'utilisateur qui distingue cette requête d'ajout asynchrone spécifique des autres requêtes.
Retours
IAsyncResult qui représente l'ajout asynchrone qui pourrait toujours être en attente.
Exceptions
Un ou plusieurs arguments ne sont pas valides.
Une erreur d'E/S s'est produite lors de l'ajout de l'enregistrement.
La séquence d'enregistrement n'a pas réussi à libérer suffisamment d'espace pour stocker le nouvel enregistrement.
La méthode a été appelée après la suppression de la séquence.
Remarques
Vous devez passer le IAsyncResult retourné par cette méthode à la méthode EndAppend pour vous assurer que l'opération d'ajout est terminée et que des ressources peuvent être libérées de façon appropriée. Si une erreur s'est produite pendant un ajout asynchrone, une exception n'est pas levée tant que la méthode EndAppend n'est pas appelée avec le IAsyncResult retourné par cette méthode.
Les données contenues dans le paramètre data
seront concaténées dans un tableau d'octets unique pour l'ajouter en tant qu'enregistrement. Toutefois, il n'est pas possible de rétablir les segments du tableau en fractionnant les données lors de la lecture de l'enregistrement.
L'enregistrement ajouté utilisera l'espace qui a été réservé précédemment, à l'aide d'une réservation spécifiée par le paramètre reservations
. Si l'ajout réussit, il utilisera la plus petite zone de réservation qui peut stocker les données et cette zone de réservation sera supprimée de la collection.
Normalement, cette méthode se termine avant que l'enregistrement ait été écrit. Pour vous assurer de l'écriture d'un enregistrement, spécifiez l'indicateur ForceFlush à l'aide du paramètre recordAppendOptions
ou appelez la méthode Flush.
S’applique à
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone à l'aide de l'espace précédemment réservé dans la séquence.
public:
IAsyncResult ^ BeginAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations, AsyncCallback callback, object state);
abstract member BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
Public Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult
Paramètres
- data
- ArraySegment<Byte>
Liste des segments de tableau d'octets qui seront concaténés et ajoutés en tant qu'enregistrement.
- nextUndoRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre spécifié par l'utilisateur.
- previousRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre précédent.
- recordAppendOptions
- RecordAppendOptions
Une valeur valide de RecordAppendOptions qui spécifie comment les données doivent être écrites.
- reservations
- ReservationCollection
ReservationCollection qui contient la réservation qui doit être utilisée pour cet enregistrement.
- callback
- AsyncCallback
Rappel asynchrone facultatif à appeler lorsque l'ajout est terminé.
- state
- Object
Objet fourni par l'utilisateur qui distingue cette requête d'ajout asynchrone spécifique des autres requêtes.
Retours
IAsyncResult qui représente l'ajout asynchrone qui pourrait toujours être en attente.
Exceptions
Un ou plusieurs arguments ne sont pas valides.
Une erreur d'E/S s'est produite lors de l'ajout de l'enregistrement.
La séquence d'enregistrement n'a pas réussi à libérer suffisamment d'espace pour stocker le nouvel enregistrement.
La méthode a été appelée après la suppression de la séquence.
Remarques
Vous devez passer le IAsyncResult retourné par cette méthode à la méthode EndAppend pour vous assurer que l'opération d'ajout est terminée et que des ressources peuvent être libérées de façon appropriée. Si une erreur s'est produite pendant un ajout asynchrone, une exception n'est pas levée tant que la méthode EndAppend n'est pas appelée avec le IAsyncResult retourné par cette méthode.
Les données contenues dans le paramètre data
seront concaténées dans un tableau d'octets unique pour l'ajouter en tant qu'enregistrement. Toutefois, il n'est pas possible de rétablir les segments du tableau en fractionnant les données lors de la lecture de l'enregistrement.
L'enregistrement ajouté utilisera l'espace qui a été réservé précédemment, à l'aide d'une réservation spécifiée par le paramètre reservations
. Si l'ajout réussit, il utilisera la plus petite zone de réservation qui peut stocker les données et cette zone de réservation sera supprimée de la collection.
Normalement, cette méthode se termine avant que l'enregistrement ait été écrit. Pour vous assurer de l'écriture d'un enregistrement, spécifiez l'indicateur ForceFlush à l'aide du paramètre recordAppendOptions
ou appelez la méthode Flush.
S’applique à
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone.
public:
IAsyncResult ^ BeginAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, AsyncCallback callback, object state);
abstract member BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResult
Public Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResult
Paramètres
- data
- ArraySegment<Byte>
Liste des segments de tableau d'octets qui seront concaténés et ajoutés en tant qu'enregistrement.
- nextUndoRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre spécifié par l'utilisateur.
- previousRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre précédent.
- recordAppendOptions
- RecordAppendOptions
Une valeur valide de RecordAppendOptions qui spécifie comment les données doivent être écrites.
- callback
- AsyncCallback
Rappel asynchrone facultatif à appeler lorsque l'ajout est terminé.
- state
- Object
Objet fourni par l'utilisateur qui distingue cette requête d'ajout asynchrone spécifique des autres requêtes.
Retours
IAsyncResult qui représente l'ajout asynchrone qui pourrait toujours être en attente.
Exceptions
Un ou plusieurs arguments ne sont pas valides.
Une erreur d'E/S s'est produite lors de l'ajout de l'enregistrement.
La séquence d'enregistrement n'a pas réussi à libérer suffisamment d'espace pour stocker le nouvel enregistrement.
La méthode a été appelée après la suppression de la séquence.
Remarques
Vous devez passer le IAsyncResult retourné par cette méthode à la méthode EndAppend pour vous assurer que l'opération d'ajout est terminée et que des ressources peuvent être libérées de façon appropriée. Si une erreur s'est produite pendant un ajout asynchrone, une exception n'est pas levée tant que la méthode EndAppend n'est pas appelée avec le IAsyncResult retourné par cette méthode.
Les données contenues dans le paramètre data
seront concaténées dans un tableau d'octets unique pour l'ajouter en tant qu'enregistrement. Toutefois, il n'est pas possible de rétablir les segments du tableau en fractionnant les données lors de la lecture de l'enregistrement.
Normalement, cette méthode se termine avant que l'enregistrement ait été écrit. Pour vous assurer de l'écriture d'un enregistrement, spécifiez l'indicateur ForceFlush à l'aide du paramètre recordAppendOptions
ou appelez la méthode Flush.
S’applique à
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
En cas de substitution dans une classe dérivée, commence une opération d'ajout asynchrone à l'aide de l'espace précédemment réservé dans la séquence.
public:
IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginAppend (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, AsyncCallback callback, object state);
abstract member BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResult
Public Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResult
Paramètres
- data
- IList<ArraySegment<Byte>>
Liste des segments de tableau d'octets qui seront concaténés et ajoutés en tant qu'enregistrement.
- nextUndoRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre spécifié par l'utilisateur.
- previousRecord
- SequenceNumber
Numéro de séquence de l'enregistrement suivant dans l'ordre précédent.
- recordAppendOptions
- RecordAppendOptions
Une valeur valide de RecordAppendOptions qui spécifie comment les données doivent être écrites.
- callback
- AsyncCallback
Rappel asynchrone facultatif à appeler lorsque l'ajout est terminé.
- state
- Object
Objet fourni par l'utilisateur qui distingue cette requête d'ajout asynchrone spécifique des autres requêtes.
Retours
IAsyncResult qui représente l'ajout asynchrone qui pourrait toujours être en attente.
Exceptions
Un ou plusieurs arguments ne sont pas valides.
Une erreur d'E/S s'est produite lors de l'ajout de l'enregistrement.
La séquence d'enregistrement n'a pas réussi à libérer suffisamment d'espace pour stocker le nouvel enregistrement.
La méthode a été appelée après la suppression de la séquence.
Remarques
Vous devez passer le IAsyncResult retourné par cette méthode à la méthode EndAppend pour vous assurer que l'opération d'ajout est terminée et que des ressources peuvent être libérées de façon appropriée. Si une erreur s'est produite pendant un ajout asynchrone, une exception n'est pas levée tant que la méthode EndAppend n'est pas appelée avec le IAsyncResult retourné par cette méthode.
Les données contenues dans le paramètre data
seront concaténées dans un tableau d'octets unique pour l'ajouter en tant qu'enregistrement. Toutefois, il n'est pas possible de rétablir les segments du tableau en fractionnant les données lors de la lecture de l'enregistrement.
Normalement, cette méthode se termine avant que l'enregistrement ait été écrit. Pour vous assurer de l'écriture d'un enregistrement, spécifiez l'indicateur ForceFlush à l'aide du paramètre recordAppendOptions
ou appelez la méthode Flush.