LogRecordSequence.BeginReserveAndAppend Metodo

Definizione

Spazio dei nomi:

System.IO.Log

Assembly:

System.IO.Log.dll

Avvia un'operazione asincrona di prenotazione e accodamento.

Overload

BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)	Avvia un'operazione asincrona di prenotazione e accodamento. Questo metodo non può essere ereditato.
BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)	Avvia un'operazione asincrona di prenotazione e accodamento. Questo metodo non può essere ereditato.

BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Avvia un'operazione asincrona di prenotazione e accodamento. Questo metodo non può essere ereditato.

public:
 virtual IAsyncResult ^ BeginReserveAndAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservationCollection, cli::array <long> ^ reservations, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReserveAndAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservationCollection, long[] reservations, AsyncCallback callback, object state);

abstract member BeginReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult
override this.BeginReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult

Public Function BeginReserveAndAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, reservations As Long(), callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

data

ArraySegment<Byte>

Elenco di segmenti della 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 RecordAppendOptions che specifica la modalità da utilizzare per la scrittura dei dati.

reservationCollection

ReservationCollection

raccolta di prenotazioni nella quale fare prenotazioni.

reservations

Int64[]

Prenotazioni da fare, in byte.

callback

AsyncCallback

Callback asincrono facoltativo, da chiamare quando l'accodamento è completo.

state

Object

Oggetto fornito dall'utente che distingue questa specifica richiesta di accodamento asincrona dalle altre richieste.

Restituisce

IAsyncResult

Interfaccia IAsyncResult che rappresenta questa operazione di cancellazione asincrona che può essere ancora in sospeso.

Implementazioni

BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Eccezioni

ArgumentException

userRecord o previousRecord non è valido per questa sequenza.

-oppure-

Non è possibile aggiungere data perché le dimensioni superano le dimensioni massime dei record.

-oppure-

reservations non è stato creato da questa sequenza di record.

ArgumentNullException

Uno o più argomenti sono null.

ArgumentOutOfRangeException

userRecord o previousRecord non è compreso tra i numeri di sequenza di base e finale di questa sequenza.

IOException

Impossibile eseguire la richiesta a causa di un'eccezione I/O imprevista.

-oppure-

Impossibile eseguire la richiesta a causa di un errore del dispositivo di I/O.

NotSupportedException

L'operazione non può essere eseguita perché la sequenza di record è stata aperta con accesso in sola lettura.

ObjectDisposedException

Il metodo è stato chiamato dopo l'eliminazione sequenza.

OutOfMemoryException

Memoria insufficiente per continuare l'esecuzione del programma.

SequenceFullException

Sequenza di record piena.

UnauthorizedAccessException

L'accesso per la sequenza dei log specificata viene negato dal sistema operativo.

ReservationNotFoundException

Impossibile trovare una prenotazione abbastanza grande da soddisfare il parametro data in reservations.

Commenti

È necessario passare l'oggetto della classe IAsyncResult restituito da questo metodo al metodo EndReserveAndAppend per garantire che l'operazione di accodamento sia stata completata e che sia possibile liberare appropriatamente le risorse. Se si è verificato un errore durante un accodamento asincrono, non viene generata alcuna eccezione fino a quando il metodo EndReserveAndAppend non viene chiamato con l'interfaccia IAsyncResult restituita da questo metodo.

I dati contenuti nel parametro data verranno concatenati in una matrice a byte singolo per essere quindi accodati come record. Tuttavia, non esiste alcun provisioning per suddividere dati in segmenti della matrice una volta letto il record.

Le prenotazioni specificate vengono aggiunte alla raccolta di prenotazioni fornita mediante un'operazione atomica con un'operazione di accodamento record. Se l'accodamento non riesce, non verrà riservato alcuno spazio.

In genere questo metodo può essere completato prima che il record sia stato scritto. Per garantire che un record è stato scritto, specificare il flag ForceFlush utilizzando il parametro recordAppendOptions oppure chiamare il metodo Flush.

Se una sequenza di record è stata eliminata o se si passa un argomento non valido, le eccezioni vengono immediatamente generate all'interno di questa operazione. Gli errori che si verificano durante una richiesta di accodamento asincrona, ad esempio un errore del disco durante una richiesta di I/O, comporteranno la generazione di eccezioni quando viene chiamato il metodo EndReserveAndAppend.

BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Avvia un'operazione asincrona di prenotazione e accodamento. Questo metodo non può essere ereditato.

public:
 virtual IAsyncResult ^ BeginReserveAndAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservationCollection, cli::array <long> ^ reservations, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReserveAndAppend (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber userRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservationCollection, long[] reservations, AsyncCallback callback, object state);

abstract member BeginReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult
override this.BeginReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult

Public Function BeginReserveAndAppend (data As IList(Of ArraySegment(Of Byte)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, reservations As Long(), callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

data

IList<ArraySegment<Byte>>

Elenco di segmenti della matrice di byte che verranno concatenati e accodati come record.

userRecord

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 RecordAppendOptions che specifica la modalità da utilizzare per la scrittura dei dati.

reservationCollection

ReservationCollection

raccolta di prenotazioni nella quale fare prenotazioni.

reservations

Int64[]

Prenotazioni da fare, in byte.

callback

AsyncCallback

Callback asincrono facoltativo, da chiamare quando l'accodamento è completo.

state

Object

Oggetto fornito dall'utente che distingue questa specifica richiesta di accodamento asincrona dalle altre richieste.

Restituisce

IAsyncResult

Interfaccia IAsyncResult che rappresenta questa operazione di cancellazione asincrona che può essere ancora in sospeso.

Implementazioni

BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Eccezioni

ArgumentException

Uno o più argomenti non sono validi.

IOException

Si è verificato un errore di I/O durante l'accodamento del record.

SequenceFullException

La sequenza di record non ha potuto fare abbastanza spazio per contenere il nuovo record, o fare la prenotazione.

ObjectDisposedException

Il metodo è stato chiamato dopo l'eliminazione sequenza.

Commenti

È necessario passare l'oggetto della classe IAsyncResult restituito da questo metodo al metodo EndReserveAndAppend per garantire che l'operazione di accodamento sia stata completata e che sia possibile liberare appropriatamente le risorse. Se si è verificato un errore durante un accodamento asincrono, non viene generata alcuna eccezione fino a quando il metodo EndReserveAndAppend non viene chiamato con l'interfaccia IAsyncResult restituita da questo metodo.

I dati contenuti nel parametro data verranno concatenati in una matrice a byte singolo per essere quindi accodati come record. Tuttavia, non esiste alcun provisioning per suddividere dati in segmenti della matrice una volta letto il record.

Le prenotazioni specificate vengono aggiunte alla raccolta di prenotazioni fornita mediante un'operazione atomica con un'operazione di accodamento record. Se l'accodamento non riesce, non verrà riservato alcuno spazio.

In genere questo metodo può essere completato prima che il record sia stato scritto. Per garantire che un record è stato scritto, specificare il flag ForceFlush utilizzando il parametro recordAppendOptions oppure chiamare il metodo Flush.

Se una sequenza di record è stata eliminata o se si passa un argomento non valido, le eccezioni vengono immediatamente generate all'interno di questa operazione. Gli errori che si verificano durante una richiesta di accodamento asincrona, ad esempio un errore del disco durante una richiesta di I/O, comporteranno la generazione di eccezioni quando viene chiamato il metodo EndReserveAndAppend.