Message.TimeToBeReceived Properti

Referensi

Definisi

Ruang nama:: System.Messaging

Rakitan:: System.Messaging.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur jumlah waktu maksimum pesan yang akan diterima dari antrean tujuan.

public:
 property TimeSpan TimeToBeReceived { TimeSpan get(); void set(TimeSpan value); };

[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, set

Public Property TimeToBeReceived As TimeSpan

Nilai Properti

TimeSpan

Total waktu untuk pesan terkirim diterima dari antrean tujuan. Default adalah InfiniteTimeout.

Atribut: TypeConverterAttribute MessagingDescriptionAttribute

Pengecualian

InvalidOperationException

Antrean pesan difilter untuk mengabaikan TimeToBeReceived properti .

ArgumentException

Nilai yang ditentukan untuk TimeToBeReceived tidak valid.

Contoh

Contoh kode berikut mendapatkan dan menetapkan nilai properti pesan TimeToBeReceived .

Keterangan

Properti TimeToBeReceived menentukan total waktu untuk pesan terkirim diterima dari antrean tujuan. Batas waktu termasuk waktu yang dihabiskan untuk sampai ke antrean tujuan dan waktu yang dihabiskan untuk menunggu dalam antrean sebelum pesan diterima.

Perhatian

Saat menggunakan komputer klien dependen, pastikan jam pada komputer klien disinkronkan dengan jam di server yang menjalankan Antrean Pesan. Jika tidak, perilaku yang tidak dapat diprediksi dapat mengakibatkan pengiriman pesan yang propertinya TimeToBeReceived bukan InfiniteTimeout.

Jika interval yang ditentukan oleh properti kedaluwarsa TimeToBeReceived sebelum pesan dihapus dari antrean, Antrean Pesan akan membuang pesan dengan salah satu dari dua cara. Jika properti pesan UseDeadLetterQueue adalah true, pesan dikirim ke antrean dead-letter. Jika UseDeadLetterQueue adalah false, pesan diabaikan.

Anda dapat mengatur properti pesan AcknowledgeType untuk meminta Antrean Pesan mengirim pesan pengakuan negatif kembali ke aplikasi pengirim jika pesan tidak diambil sebelum timer kedaluwarsa.

Jika nilai yang ditentukan oleh TimeToBeReceived properti kurang dari nilai yang ditentukan oleh TimeToReachQueue properti , TimeToBeReceived lebih diutamakan.

Saat beberapa pesan dikirim dalam satu transaksi, Antrean Pesan menggunakan TimeToBeReceived properti pesan pertama.

Berlaku untuk

Bagikan melalui