IRecordSequence.BeginWriteRestartArea 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 scrittura dell'area di riavvio asincrona.
Overload
| Nome | Descrizione |
|---|---|
| BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object) |
Quando sottoposto a override in una classe derivata, avvia un'operazione di scrittura asincrona dell'area di riavvio, usando lo spazio precedentemente riservato nella sequenza. |
| BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object) |
Quando sottoposto a override in una classe derivata, avvia un'operazione di scrittura asincrona dell'area di riavvio, usando lo spazio precedentemente riservato nella sequenza. |
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)
Quando sottoposto a override in una classe derivata, avvia un'operazione di scrittura asincrona dell'area di riavvio, usando lo spazio precedentemente riservato nella sequenza.
public:
IAsyncResult ^ BeginWriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginWriteRestartArea(ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);abstract member BeginWriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResultPublic Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation 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.
- newBaseSequenceNumber
- SequenceNumber
Nuovo numero di sequenza di base. Il numero di sequenza specificato deve essere maggiore o uguale al numero di sequenza di base corrente.
- reservation
- ReservationCollection
Oggetto ReservationCollection contenente la prenotazione che deve essere utilizzata per questa area di riavvio.
- callback
- AsyncCallback
Callback asincrono facoltativo da chiamare al termine della scrittura dell'area di riavvio.
- state
- Object
Oggetto fornito dall'utente che distingue questa particolare richiesta di scrittura dell'area di riavvio asincrona da altre richieste.
Valori restituiti
Oggetto IAsyncResult che rappresenta l'operazione di scrittura dell'area di riavvio asincrona, che potrebbe essere ancora in sospeso.
Commenti
È necessario passare l'oggetto IAsyncResult restituito da questo metodo al EndWriteRestartArea metodo , per assicurarsi che l'operazione di scrittura dell'area di riavvio sia stata completata e che le risorse possano essere liberate in modo appropriato. Se si è verificato un errore durante un'operazione di scrittura dell'area di riavvio asincrona, non viene generata un'eccezione finché il EndWriteRestartArea 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.
Al termine dell'operazione, il numero di sequenza di base è stato aggiornato. Tutti i record di log con numeri di sequenza inferiori al nuovo numero di sequenza di base non sono accessibili.
Se si specifica un ReservationCollection oggetto , l'area di riavvio scritta utilizzerà lo spazio precedentemente riservato, utilizzando una prenotazione contenuta nella raccolta. Se il metodo ha esito positivo, utilizzerà la prenotazione più piccola che può contenere i dati e tale prenotazione verrà rimossa dalla raccolta.
Se una sequenza di record è stata eliminata o se si passa un argomento non valido, le eccezioni vengono generate immediatamente all'interno di questa operazione. Gli errori che si sono verificati durante una richiesta di accodamento asincrona, ad esempio un errore del disco durante la richiesta di I/O, genereranno eccezioni generate quando viene chiamato il EndWriteRestartArea metodo .
Si applica a
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)
Quando sottoposto a override in una classe derivata, avvia un'operazione di scrittura asincrona dell'area di riavvio, usando lo spazio precedentemente riservato nella sequenza.
public:
IAsyncResult ^ BeginWriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginWriteRestartArea(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);abstract member BeginWriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResultPublic Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation 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.
- newBaseSequenceNumber
- SequenceNumber
Nuovo numero di sequenza di base. Il numero di sequenza specificato deve essere maggiore o uguale al numero di sequenza di base corrente.
- reservation
- ReservationCollection
Oggetto ReservationCollection contenente la prenotazione che deve essere utilizzata per questa area di riavvio.
- callback
- AsyncCallback
Callback asincrono facoltativo da chiamare al termine della scrittura dell'area di riavvio.
- state
- Object
Oggetto fornito dall'utente che distingue questa particolare richiesta di scrittura dell'area di riavvio asincrona da altre richieste.
Valori restituiti
Oggetto IAsyncResult che rappresenta l'operazione di scrittura dell'area di riavvio asincrona, che potrebbe essere ancora in sospeso.
Eccezioni
Uno o più argomenti non sono validi.
Si è verificato un errore di I/O durante la scrittura dell'area di riavvio.
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 EndWriteRestartArea metodo per assicurarsi che l'operazione di scrittura dell'area di riavvio sia stata completata e che le risorse possano essere liberate in modo appropriato. Se si è verificato un errore durante un'operazione di scrittura dell'area di riavvio asincrona, non viene generata un'eccezione finché il EndWriteRestartArea 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.
Al termine dell'operazione, il numero di sequenza di base è stato aggiornato. Tutti i record di log con numeri di sequenza inferiori al nuovo numero di sequenza di base non sono accessibili.
Se si specifica un ReservationCollection oggetto , l'area di riavvio scritta utilizzerà lo spazio precedentemente riservato, utilizzando una prenotazione contenuta nella raccolta. Se il metodo ha esito positivo, utilizzerà la prenotazione più piccola che può contenere i dati e tale prenotazione verrà rimossa dalla raccolta.
Se una sequenza di record è stata eliminata o se si passa un argomento non valido, le eccezioni vengono generate immediatamente all'interno di questa operazione. Gli errori che si sono verificati durante una richiesta di accodamento asincrona, ad esempio un errore del disco durante la richiesta di I/O, genereranno eccezioni generate quando viene chiamato il EndWriteRestartArea metodo .
