LogRecordSequence.BeginWriteRestartArea Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO.Log
Bütünleştirilmiş Kod:
System.IO.Log.dll

Zaman uyumsuz bir yeniden başlatma alanı yazma işlemi başlatır.

Aşırı Yüklemeler

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

Daha önce dizide ayrılmış olan alanı kullanarak zaman uyumsuz bir yeniden başlatma alanı yazma işlemi başlatır. Bu yöntem devralınamaz.
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Daha önce dizide ayrılmış olan alanı kullanarak zaman uyumsuz bir yeniden başlatma alanı yazma işlemi başlatır. Bu yöntem devralınamaz.

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

Daha önce dizide ayrılmış olan alanı kullanarak zaman uyumsuz bir yeniden başlatma alanı yazma işlemi başlatır. Bu yöntem devralınamaz.

public:
 virtual IAsyncResult ^ BeginWriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSeqNum, System::IO::Log::ReservationCollection ^ reservationCollection, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginWriteRestartArea (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSeqNum, System.IO.Log.ReservationCollection reservationCollection, AsyncCallback callback, object state);
abstract member BeginWriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
override this.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)), newBaseSeqNum As SequenceNumber, reservationCollection As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

data
IList<ArraySegment<Byte>>

Birleştirilmiş ve kayıt olarak eklenecek bayt dizisi kesimlerinin listesi.

newBaseSeqNum
SequenceNumber

Yeni temel sıra numarası. Belirtilen sıra numarası geçerli temel sıra numarasından büyük veya buna eşit olmalıdır.

reservationCollection
ReservationCollection

ReservationCollection Bu yeniden başlatma alanı için kullanılması gereken rezervasyonu içeren.

callback
AsyncCallback

Yeniden başlatma alanı yazma işlemi tamamlandığında çağrılmak üzere isteğe bağlı bir zaman uyumsuz geri çağırma.

state
Object

Bu belirli zaman uyumsuz yeniden başlatma alanı yazma isteğini diğer isteklerden ayıran kullanıcı tarafından sağlanan bir nesne.

Döndürülenler

IAsyncResult

IAsyncResult Hala beklemede olabilecek zaman uyumsuz yeniden başlatma alanı yazma işlemini temsil eden bir.

Uygulamalar

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

Özel durumlar

ArgumentException

newBaseSeqNum bu dizi için geçerli değil.

-veya-

Belirtilen günlük numaralandırması başlangıç dizisi numarası geçersiz.

-veya-

data kayıt boyutu üst sınırından büyük olduğundan eklenemiyor.

-veya-

reservationCollection bu kayıt dizisi tarafından oluşturulmadı.

ArgumentNullException

Parametrelerden biri veya daha fazlası şeklindedir null.

ArgumentOutOfRangeException

Etkin günlüğün yeni veya var olan arşiv kuyruğu veya tabanı geçersiz.

-veya-

newBaseSeqNum bu dizinin temel ve son sıra numaraları arasında değildir.

IOException

İstek beklenmeyen bir G/Ç özel durumu nedeniyle gerçekleştirilemedi.

-veya-

G/Ç cihazı hatası nedeniyle istek gerçekleştirilemedi.

ObjectDisposedException

yöntemi, dizisi atıldıktan sonra çağrılır.

OutOfMemoryException

Programın yürütülmesine devam etmek için yeterli bellek yok.

UnauthorizedAccessException

Belirtilen günlük dizisine erişim işletim sistemi tarafından reddedildi.

SequenceFullException

Kayıt dizisi dolu.

Açıklamalar

Yeniden başlatma alanı yazma işleminin IAsyncResult tamamlandığından EndWriteRestartArea ve kaynakların uygun şekilde serbest olduğundan emin olmak için bu yöntem tarafından döndürülen öğesini yöntemine geçirmeniz gerekir. Zaman uyumsuz bir yeniden başlatma alanı yazma işlemi sırasında bir hata oluştuysa, yöntem bu yöntem tarafından döndürülen ile IAsyncResult çağrılana EndWriteRestartArea kadar bir özel durum oluşmaz.

parametresinde data bulunan veriler, kayıt olarak eklemek için tek bir bayt dizisine birleştirilir. Ancak, kayıt okunduğunda verileri dizi kesimlerine bölmek için herhangi bir sağlama yapılmaz.

İşlem başarıyla tamamlandığında, temel sıra numarası güncelleştirilir. Yeni temel sıra numarasından küçük sıra numaralarına sahip tüm günlük kayıtlarına erişilemez.

ReservationCollection belirtilirse, yazılı yeniden başlatma alanı koleksiyonda yer alan bir rezervasyon kullanılarak önceden ayrılmış olan alanı tüketir. Yöntem başarılı olursa, verileri tutabilecek en küçük rezervasyonu kullanır ve bu rezervasyon koleksiyondan kaldırılır.

Bir kayıt dizisi atılmışsa veya geçersiz bir bağımsız değişken geçirirseniz, bu işlem içinde hemen özel durumlar oluşturulur. Zaman uyumsuz ekleme isteği sırasında oluşan hatalar, örneğin G/Ç isteği sırasında bir disk hatası, yöntem çağrıldığında özel durumların atılmasıyla EndWriteRestartArea sonuçlanır.

Şunlara uygulanır

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

Daha önce dizide ayrılmış olan alanı kullanarak zaman uyumsuz bir yeniden başlatma alanı yazma işlemi başlatır. Bu yöntem devralınamaz.

public:
 virtual IAsyncResult ^ BeginWriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSeqNum, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginWriteRestartArea (ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSeqNum, 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
override this.BeginWriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
Public Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSeqNum As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

data
ArraySegment<Byte>

Birleştirilmiş ve kayıt olarak eklenecek bayt dizisi kesimleri.

newBaseSeqNum
SequenceNumber

Yeni temel sıra numarası. Belirtilen sıra numarası geçerli temel sıra numarasından büyük veya buna eşit olmalıdır.

reservation
ReservationCollection

ReservationCollection Bu yeniden başlatma alanı için kullanılması gereken rezervasyonu içeren.

callback
AsyncCallback

Yeniden başlatma alanı yazma işlemi tamamlandığında çağrılmak üzere isteğe bağlı bir zaman uyumsuz geri çağırma.

state
Object

Bu belirli zaman uyumsuz yeniden başlatma alanı yazma isteğini diğer isteklerden ayıran kullanıcı tarafından sağlanan bir nesne.

Döndürülenler

IAsyncResult

IAsyncResult Hala beklemede olabilecek zaman uyumsuz yeniden başlatma alanı yazma işlemini temsil eden bir.

Uygulamalar

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

Özel durumlar

ArgumentException

newBaseSeqNum bu dizi için geçerli değil.

-veya-

Belirtilen günlük numaralandırması başlangıç dizisi numarası geçersiz.

-veya-

data kayıt boyutu üst sınırından büyük olduğundan eklenemiyor.

-veya-

reservation bu kayıt dizisi tarafından oluşturulmadı.

ArgumentNullException

Parametrelerden biri veya daha fazlası şeklindedir null.

ArgumentOutOfRangeException

Etkin günlüğün yeni veya var olan arşiv kuyruğu veya tabanı geçersiz.

-veya-

newBaseSeqNum bu dizinin temel ve son sıra numaraları arasında değildir.

IOException

İstek beklenmeyen bir G/Ç özel durumu nedeniyle gerçekleştirilemedi.

-veya-

G/Ç cihazı hatası nedeniyle istek gerçekleştirilemedi.

ObjectDisposedException

yöntemi, dizisi atıldıktan sonra çağrılır.

OutOfMemoryException

Programın yürütülmesine devam etmek için yeterli bellek yok.

UnauthorizedAccessException

Belirtilen günlük dizisine erişim işletim sistemi tarafından reddedildi.

SequenceFullException

Kayıt dizisi dolu.

Açıklamalar

Yeniden başlatma alanı yazma işleminin IAsyncResult tamamlandığından EndWriteRestartArea ve kaynakların uygun şekilde serbest olduğundan emin olmak için bu yöntem tarafından döndürülen öğesini yöntemine geçirmeniz gerekir. Zaman uyumsuz bir yeniden başlatma alanı yazma işlemi sırasında bir hata oluştuysa, yöntem bu yöntem tarafından döndürülen ile IAsyncResult çağrılana EndWriteRestartArea kadar bir özel durum oluşmaz.

parametresinde data bulunan veriler, kayıt olarak eklemek için tek bir bayt dizisine birleştirilir. Ancak, kayıt okunduğunda verileri dizi kesimlerine bölmek için herhangi bir sağlama yapılmaz.

İşlem başarıyla tamamlandığında, temel sıra numarası güncelleştirilir. Yeni temel sıra numarasından küçük sıra numaralarına sahip tüm günlük kayıtlarına erişilemez.

ReservationCollection belirtilirse, yazılı yeniden başlatma alanı koleksiyonda yer alan bir rezervasyon kullanılarak önceden ayrılmış olan alanı tüketir. Yöntem başarılı olursa, verileri tutabilecek en küçük rezervasyonu kullanır ve bu rezervasyon koleksiyondan kaldırılır.

Bir kayıt dizisi atılmışsa veya geçersiz bir bağımsız değişken geçirirseniz, bu işlem içinde hemen özel durumlar oluşturulur. Zaman uyumsuz ekleme isteği sırasında oluşan hatalar, örneğin G/Ç isteği sırasında bir disk hatası, yöntem çağrıldığında özel durumların atılmasıyla EndWriteRestartArea sonuçlanır.

Şunlara uygulanır