LogRecordSequence.BeginWriteRestartArea Yöntem

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

Name	Description
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Daha önce dizide ayrılmış 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ış 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ış 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 bir.

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 Zaman uyumsuz yeniden başlatma alanı yazma işlemini temsil eden ve hala bekliyor olabilir.

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 en büyük kayıt boyutundan 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, dizi atıldıktan sonra çağrıldı.

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 reddedilir.

SequenceFullException

Kayıt dizisi dolu.

Açıklamalar

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

parametresinde data bulunan veriler, kayıt olarak eklenmek üzere 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 rezervasyonu kullanarak daha önce ayrılmış olan alanı kullanır. 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öntemi çağrıldığında özel durumların atılmasıyla EndWriteRestartArea sonuçlanır.

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

Daha önce dizide ayrılmış 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ştirilir ve kayıt olarak eklenir 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 bir.

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 Zaman uyumsuz yeniden başlatma alanı yazma işlemini temsil eden ve hala bekliyor olabilir.

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 en büyük kayıt boyutundan 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, dizi atıldıktan sonra çağrıldı.

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 reddedilir.

SequenceFullException

Kayıt dizisi dolu.

Açıklamalar

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

parametresinde data bulunan veriler, kayıt olarak eklenmek üzere 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 rezervasyonu kullanarak daha önce ayrılmış olan alanı kullanır. 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öntemi çağrıldığında özel durumların atılmasıyla EndWriteRestartArea sonuçlanır.