LogRecordSequence.BeginFlush(SequenceNumber, AsyncCallback, Object) Metodo

Definizione

Avvia un'operazione di scaricamento asincrono, utilizzando spazio precedentemente riservato nella sequenza.Begins an asynchronous flush operation, using space previously reserved in the sequence. Questo metodo non può essere ereditato.This method cannot be inherited.

public:
 virtual IAsyncResult ^ BeginFlush(System::IO::Log::SequenceNumber sequenceNumber, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginFlush (System.IO.Log.SequenceNumber sequenceNumber, AsyncCallback callback, object state);
abstract member BeginFlush : System.IO.Log.SequenceNumber * AsyncCallback * obj -> IAsyncResult
override this.BeginFlush : System.IO.Log.SequenceNumber * AsyncCallback * obj -> IAsyncResult

Parametri

sequenceNumber
SequenceNumber

Numero di sequenza dell'ultimo record che deve essere scritto.The sequence number of the latest record that must be written. Se SequenceNumber non è valido, devono essere scritti tutti i record.If this SequenceNumber is invalid, then all records must be written.

callback
AsyncCallback

Callback asincrono facoltativo, da chiamare quando lo scaricamento è stato completato.An optional asynchronous callback, to be called when the flush is complete.

state
Object

Oggetto fornito dall'utente che distingue questa specifica richiesta di scaricamento asincrono da altre richieste.A user-provided object that distinguishes this particular asynchronous flush request from other requests.

Restituisce

Interfaccia IAsyncResult che rappresenta l'operazione di scaricamento asincrono che può essere ancora in sospeso.An IAsyncResult that represents the asynchronous flush operation, which could still be pending.

Implementazioni

Eccezioni

sequenceNumber non è valido per questa sequenza.sequenceNumber is not valid for this sequence.

sequenceNumber non è compreso tra i numeri di sequenza di base e finale di questa sequenza.sequenceNumber is not between the base and last sequence numbers of this sequence.

Impossibile eseguire la richiesta a causa di un'eccezione I/O imprevista.The request could not be performed because of an unexpected I/O exception.

Nel log specificato non esistono extent.The specified log does not have any extents. Prima di utilizzare una sequenza di record, è necessario creare uno o più extent.One or more extents must be created before a record sequence can be used.

L'operazione non può essere eseguita perché la sequenza di record è stata aperta con accesso in sola lettura.The operation cannot be performed because the record sequence was opened with read-only access.

Il metodo è stato chiamato dopo l'eliminazione sequenza.The method was called after the sequence has been disposed of.

Memoria insufficiente per continuare l'esecuzione del programma.There is not enough memory to continue the execution of the program.

Sequenza di record piena.The record sequence is full.

L'accesso per la sequenza dei log specificata viene negato dal sistema operativo.Access for the specified log sequence is denied by the operating system.

Commenti

È necessario passare l'interfaccia IAsyncResult restituita dal metodo corrente al metodo EndFlush per garantire che lo scaricamento venga completato e le risorse vengano liberate in modo appropriato.You should pass the IAsyncResult returned by the current method to the EndFlush method to ensure that the flush completes and resources are freed appropriately. Se si verifica un errore durante un'operazione di scaricamento asincrono, non viene generata alcuna eccezione fino a quando il metodo EndFlush non viene chiamato con il valore IAsyncResult restituito da questo metodo.If an error occurs during an asynchronous flush, an exception is not thrown until the EndFlush method is called with the IAsyncResult returned by this method.

La chiamata a questo metodo garantisce che tutti i record accodati all'interfaccia LogRecordSequence siano scritti in modo durevole.Calling this method ensures that all records that have been appended to the LogRecordSequence are durably written.

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.If a record sequence has been disposed of, or if you pass an invalid argument, exceptions are thrown immediately within this operation. Gli errori che si verificano durante una richiesta di scaricamento asincrono, ad esempio un errore del disco durante una richiesta di I/O, comportano la generazione di eccezioni quando viene chiamato il metodo EndFlush.Errors that occurred during an asynchronous flush request, for example, a disk failure during the I/O request, will result in exceptions being thrown when the EndFlush method is called.

Si applica a