IRecordSequence.BeginAppend Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona.
Overload
| Nome | Descrizione |
|---|---|
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona, usando lo spazio precedentemente riservato nella sequenza. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona usando lo spazio precedentemente riservato nella sequenza. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona. |
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona, usando lo spazio precedentemente riservato nella sequenza. |
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona, usando lo spazio precedentemente riservato nella sequenza.
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 -> IAsyncResultPublic 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 IAsyncResultParametri
- data
- IList<ArraySegment<Byte>>
Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.
- nextUndoRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine specificato dall'utente.
- previousUndoRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine precedente.
- recordAppendOptions
- RecordAppendOptions
Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.
- reservations
- ReservationCollection
Oggetto ReservationCollection contenente la prenotazione che deve essere utilizzata per questo record.
- callback
- AsyncCallback
Callback asincrono facoltativo da chiamare al termine dell'accodamento.
- state
- Object
Oggetto fornito dall'utente che distingue questa particolare richiesta di accodamento asincrona da altre richieste.
Valori restituiti
Oggetto IAsyncResult che rappresenta l'accodamento asincrono, che potrebbe essere ancora in sospeso.
Eccezioni
Uno o più argomenti non sono validi.
Errore di I/O durante l'aggiunta del record.
La sequenza di record non è riuscita a liberare spazio sufficiente per contenere il nuovo record.
Il metodo è stato chiamato dopo che la sequenza è stata eliminata.
Commenti
È necessario passare l'oggetto IAsyncResult restituito da questo metodo al EndAppend metodo per assicurarsi che l'operazione di accodamento sia stata completata e che le risorse possano essere liberate in modo appropriato. Se si è verificato un errore durante un accodamento asincrono, non viene generata un'eccezione finché il EndAppend metodo non viene chiamato con l'oggetto IAsyncResult restituito da questo metodo.
I dati contenuti nel data parametro verranno concatenati in una singola matrice di byte per l'aggiunta come record. Tuttavia, non viene effettuato alcun provisioning per la suddivisione dei dati in segmenti di matrice quando il record viene letto.
Il record accodato utilizzerà lo spazio precedentemente riservato, usando una prenotazione specificata dal reservations parametro . Se l'accodamento ha esito positivo, utilizzerà l'area di prenotazione più piccola che può contenere i dati e tale area di prenotazione verrà rimossa dalla raccolta.
In genere, questo metodo viene completato prima della scrittura del record. Per assicurarsi che sia stato scritto un record, specificare il ForceFlush flag usando il recordAppendOptions parametro o chiamare il Flush metodo .
Si applica a
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona usando lo spazio precedentemente riservato nella sequenza.
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 -> IAsyncResultPublic 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 IAsyncResultParametri
- data
- ArraySegment<Byte>
Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.
- nextUndoRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine specificato dall'utente.
- previousRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine precedente.
- recordAppendOptions
- RecordAppendOptions
Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.
- reservations
- ReservationCollection
Oggetto ReservationCollection contenente la prenotazione che deve essere utilizzata per questo record.
- callback
- AsyncCallback
Callback asincrono facoltativo da chiamare al termine dell'accodamento.
- state
- Object
Oggetto fornito dall'utente che distingue questa particolare richiesta di accodamento asincrona da altre richieste.
Valori restituiti
Oggetto IAsyncResult che rappresenta l'accodamento asincrono, che potrebbe essere ancora in sospeso.
Eccezioni
Uno o più argomenti non sono validi.
Errore di I/O durante l'aggiunta del record.
La sequenza di record non è riuscita a liberare spazio sufficiente per contenere il nuovo record.
Il metodo è stato chiamato dopo che la sequenza è stata eliminata.
Commenti
È necessario passare l'oggetto IAsyncResult restituito da questo metodo al EndAppend metodo per assicurarsi che l'operazione di accodamento sia stata completata e che le risorse possano essere liberate in modo appropriato. Se si è verificato un errore durante un accodamento asincrono, non viene generata un'eccezione finché il EndAppend metodo non viene chiamato con l'oggetto IAsyncResult restituito da questo metodo.
I dati contenuti nel data parametro verranno concatenati in una singola matrice di byte per l'aggiunta come record. Tuttavia, non viene effettuato alcun provisioning per la suddivisione dei dati in segmenti di matrice quando il record viene letto.
Il record accodato utilizzerà lo spazio precedentemente riservato, usando una prenotazione specificata dal reservations parametro . Se l'accodamento ha esito positivo, utilizzerà l'area di prenotazione più piccola che può contenere i dati e tale area di prenotazione verrà rimossa dalla raccolta.
In genere, questo metodo viene completato prima della scrittura del record. Per assicurarsi che sia stato scritto un record, specificare il ForceFlush flag usando il recordAppendOptions parametro o chiamare il Flush metodo .
Si applica a
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona.
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 -> IAsyncResultPublic Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResultParametri
- data
- ArraySegment<Byte>
Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.
- nextUndoRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine specificato dall'utente.
- previousRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine precedente.
- recordAppendOptions
- RecordAppendOptions
Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.
- callback
- AsyncCallback
Callback asincrono facoltativo da chiamare al termine dell'accodamento.
- state
- Object
Oggetto fornito dall'utente che distingue questa particolare richiesta di accodamento asincrona da altre richieste.
Valori restituiti
Oggetto IAsyncResult che rappresenta l'accodamento asincrono, che potrebbe essere ancora in sospeso.
Eccezioni
Uno o più argomenti non sono validi.
Errore di I/O durante l'aggiunta del record.
La sequenza di record non è riuscita a liberare spazio sufficiente per contenere il nuovo record.
Il metodo è stato chiamato dopo che la sequenza è stata eliminata.
Commenti
È necessario passare l'oggetto IAsyncResult restituito da questo metodo al EndAppend metodo per assicurarsi che l'operazione di accodamento sia stata completata e che le risorse possano essere liberate in modo appropriato. Se si è verificato un errore durante un accodamento asincrono, non viene generata un'eccezione finché il EndAppend metodo non viene chiamato con l'oggetto IAsyncResult restituito da questo metodo.
I dati contenuti nel data parametro verranno concatenati in una singola matrice di byte per l'aggiunta come record. Tuttavia, non viene effettuato alcun provisioning per la suddivisione dei dati in segmenti di matrice quando il record viene letto.
In genere, questo metodo viene completato prima della scrittura del record. Per assicurarsi che sia stato scritto un record, specificare il ForceFlush flag usando il recordAppendOptions parametro o chiamare il Flush metodo .
Si applica a
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Quando sottoposto a override in una classe derivata, avvia un'operazione di accodamento asincrona, usando lo spazio precedentemente riservato nella sequenza.
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 -> IAsyncResultPublic 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 IAsyncResultParametri
- data
- IList<ArraySegment<Byte>>
Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.
- nextUndoRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine specificato dall'utente.
- previousRecord
- SequenceNumber
Numero di sequenza del record successivo nell'ordine precedente.
- recordAppendOptions
- RecordAppendOptions
Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.
- callback
- AsyncCallback
Callback asincrono facoltativo da chiamare al termine dell'accodamento.
- state
- Object
Oggetto fornito dall'utente che distingue questa particolare richiesta di accodamento asincrona da altre richieste.
Valori restituiti
Oggetto IAsyncResult che rappresenta l'accodamento asincrono, che potrebbe essere ancora in sospeso.
Eccezioni
Uno o più argomenti non sono validi.
Errore di I/O durante l'aggiunta del record.
La sequenza di record non è riuscita a liberare spazio sufficiente per contenere il nuovo record.
Il metodo è stato chiamato dopo che la sequenza è stata eliminata.
Commenti
È necessario passare l'oggetto IAsyncResult restituito da questo metodo al EndAppend metodo per assicurarsi che l'operazione di accodamento sia stata completata e che le risorse possano essere liberate in modo appropriato. Se si è verificato un errore durante un accodamento asincrono, non viene generata un'eccezione finché il EndAppend metodo non viene chiamato con l'oggetto IAsyncResult restituito da questo metodo.
I dati contenuti nel data parametro verranno concatenati in una singola matrice di byte per l'aggiunta come record. Tuttavia, non viene effettuato alcun provisioning per la suddivisione dei dati in segmenti di matrice quando il record viene letto.
In genere, questo metodo viene completato prima della scrittura del record. Per assicurarsi che sia stato scritto un record, specificare il ForceFlush flag usando il recordAppendOptions parametro o chiamare il Flush metodo .
