IRecordSequence.BeginWriteRestartArea Methode

Definition

Wenn eine abgeleitete Klasse überschrieben wird, beginnt ein asynchroner Neustartbereich-Schreibvorgang.

Überlädt

Name Beschreibung
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, beginnt ein asynchroner Neustartbereich-Schreibvorgang, wobei der zuvor reservierte Speicherplatz in der Sequenz verwendet wird.

BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, beginnt ein asynchroner Neustartbereich-Schreibvorgang, wobei der zuvor reservierte Speicherplatz in der Sequenz verwendet wird.

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, beginnt ein asynchroner Neustartbereich-Schreibvorgang, wobei der zuvor reservierte Speicherplatz in der Sequenz verwendet wird.

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 -> IAsyncResult
Public Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

data
ArraySegment<Byte>

Eine Liste der Bytearraysegmente, die als Datensatz verkettet und angefügt werden.

newBaseSequenceNumber
SequenceNumber

Die neue Basissequenznummer. Die angegebene Sequenznummer muss größer oder gleich der aktuellen Basissequenznummer sein.

reservation
ReservationCollection

A ReservationCollection that contains the reservation that should be used for this restart area.

callback
AsyncCallback

Ein optionaler asynchroner Rückruf, der aufgerufen werden soll, wenn der Schreibvorgang des Neustartbereichs abgeschlossen ist.

state
Object

Ein vom Benutzer bereitgestelltes Objekt, das diese spezielle asynchrone Schreibanforderung für den Neustartbereich von anderen Anforderungen unterscheidet.

Gibt zurück

Ein IAsyncResult Wert, der den asynchronen Neustartbereich-Schreibvorgang darstellt, der noch aussteht.

Hinweise

Sie sollten die IAsyncResult von dieser Methode zurückgegebene Methode an die EndWriteRestartArea Methode übergeben, um sicherzustellen, dass der Schreibvorgang für den Neustartbereich abgeschlossen ist und Ressourcen entsprechend freigegeben werden können. Wenn während eines asynchronen Neustartbereich-Schreibvorgangs ein Fehler aufgetreten ist, wird eine Ausnahme erst ausgelöst, wenn die EndWriteRestartArea Methode mit der IAsyncResult von dieser Methode zurückgegebenen Methode aufgerufen wird.

Daten, die data im Parameter enthalten sind, werden als Datensatz in ein einzelnes Bytearray verkettet. Beim Lesen des Datensatzes werden jedoch keine Daten wieder in Arraysegmente aufgeteilt.

Wenn der Vorgang erfolgreich abgeschlossen wurde, wurde die Basissequenznummer aktualisiert. Auf alle Protokolldatensätze mit Sequenznummern kleiner als die neue Basissequenznummer kann nicht zugegriffen werden.

Wenn ein ReservationCollection Wert angegeben ist, verbraucht der geschriebene Neustartbereich Speicherplatz, der zuvor reserviert wurde, unter Verwendung einer Reservierung in der Sammlung. Wenn die Methode erfolgreich ist, verbraucht sie die kleinste Reservierung, die die Daten enthalten kann, und diese Reservierung wird aus der Sammlung entfernt.

Wenn eine Datensatzsequenz verworfen wurde oder Wenn Sie ein ungültiges Argument übergeben, werden Ausnahmen sofort innerhalb dieses Vorgangs ausgelöst. Fehler, die während einer asynchronen Anfügeanforderung aufgetreten sind, z. B. ein Datenträgerfehler während der E/A-Anforderung, führen dazu, dass Ausnahmen ausgelöst werden, wenn die EndWriteRestartArea Methode aufgerufen wird.

Gilt für:

BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, beginnt ein asynchroner Neustartbereich-Schreibvorgang, wobei der zuvor reservierte Speicherplatz in der Sequenz verwendet wird.

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 -> IAsyncResult
Public Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

data
IList<ArraySegment<Byte>>

Eine Liste der Bytearraysegmente, die als Datensatz verkettet und angefügt werden.

newBaseSequenceNumber
SequenceNumber

Die neue Basissequenznummer. Die angegebene Sequenznummer muss größer oder gleich der aktuellen Basissequenznummer sein.

reservation
ReservationCollection

A ReservationCollection that contains the reservation that should be used for this restart area.

callback
AsyncCallback

Ein optionaler asynchroner Rückruf, der aufgerufen werden soll, wenn der Schreibvorgang des Neustartbereichs abgeschlossen ist.

state
Object

Ein vom Benutzer bereitgestelltes Objekt, das diese spezielle asynchrone Schreibanforderung für den Neustartbereich von anderen Anforderungen unterscheidet.

Gibt zurück

Ein IAsyncResult Wert, der den asynchronen Neustartbereich-Schreibvorgang darstellt, der noch aussteht.

Ausnahmen

Mindestens eines der Argumente ist ungültig.

Beim Schreiben des Neustartbereichs ist ein E/A-Fehler aufgetreten.

Die Datensatzsequenz konnte nicht genügend freien Speicherplatz schaffen, um den neuen Datensatz zu enthalten.

Die Methode wurde aufgerufen, nachdem die Sequenz verworfen wurde.

Hinweise

Sie sollten die IAsyncResult von dieser Methode zurückgegebene Methode an die EndWriteRestartArea Methode übergeben, um sicherzustellen, dass der Schreibvorgang für den Neustartbereich abgeschlossen ist und Ressourcen entsprechend freigegeben werden können. Wenn während eines asynchronen Neustartbereich-Schreibvorgangs ein Fehler aufgetreten ist, wird eine Ausnahme erst ausgelöst, wenn die EndWriteRestartArea Methode mit der IAsyncResult von dieser Methode zurückgegebenen Methode aufgerufen wird.

Daten, die data im Parameter enthalten sind, werden als Datensatz in ein einzelnes Bytearray verkettet. Beim Lesen des Datensatzes werden jedoch keine Daten wieder in Arraysegmente aufgeteilt.

Wenn der Vorgang erfolgreich abgeschlossen wurde, wurde die Basissequenznummer aktualisiert. Auf alle Protokolldatensätze mit Sequenznummern kleiner als die neue Basissequenznummer kann nicht zugegriffen werden.

Wenn ein ReservationCollection Wert angegeben ist, verbraucht der geschriebene Neustartbereich Speicherplatz, der zuvor reserviert wurde, unter Verwendung einer Reservierung in der Sammlung. Wenn die Methode erfolgreich ist, verbraucht sie die kleinste Reservierung, die die Daten enthalten kann, und diese Reservierung wird aus der Sammlung entfernt.

Wenn eine Datensatzsequenz verworfen wurde oder Wenn Sie ein ungültiges Argument übergeben, werden Ausnahmen sofort innerhalb dieses Vorgangs ausgelöst. Fehler, die während einer asynchronen Anfügeanforderung aufgetreten sind, z. B. ein Datenträgerfehler während der E/A-Anforderung, führen dazu, dass Ausnahmen ausgelöst werden, wenn die EndWriteRestartArea Methode aufgerufen wird.

Gilt für: