Message.TimeToBeReceived Properti
Definisi
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
Total waktu untuk pesan terkirim diterima dari antrean tujuan. Default adalah InfiniteTimeout.
- Atribut
Pengecualian
Antrean pesan difilter untuk mengabaikan TimeToBeReceived properti .
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.