MessageQueueInstaller Sınıf

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Uygulamanızın çalışması için ihtiyaç duyduğu bir kuyruğu yüklemenize ve yapılandırmanıza olanak tanır. Bu sınıf, yükleme yardımcı programı tarafından çağrılır, örneğin, InstallUtil.exe yüklerken MessageQueue.

public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Devralma

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Açıklamalar

MessageQueueInstaller, yükleme yardımcı programı tarafından kuyrukla ilişkili kayıt defteri değerlerini yazmak için kullanılır. Yükleme yardımcı programları hakkında daha fazla bilgi için bkz. Installutil.exe (Yükleyici Aracı).

Bir kuyruk yüklemek için, öğesinden Installerdevralan bir proje yükleyici sınıfı oluşturun ve sınıfı için öğesini olarak trueayarlayınRunInstallerAttribute. Projenizde, yüklemedeki her kuyruk için bir MessageQueueInstaller örnek oluşturun ve örneği proje yükleyici sınıfınıza ekleyin.

Örnek MessageQueueInstaller oluştururken, isteğe bağlı olarak var olan MessageQueue bir örneği (örneğin, bir test sunucusundan) oluşturucuya MessageQueueInstaller geçirebilirsiniz. Bu yaklaşım, geçirilen kuyruğun ayarlarını yansıtarak yeni kuyruğun yapılandırma ayarlarını otomatik olarak sağlar. Alternatif olarak, örnekteki MessageQueueInstaller özellikleri el ile istediğiniz durumlara ayarlayabilir ve parametresiz oluşturucuyu çağırabilirsiniz.

Yükleme yardımcı programı çağrıldığında öğesini arar RunInstallerAttribute. ise true, yardımcı programı proje yükleyicinizle ilişkili koleksiyondaki Installers tüm kuyrukları yükler. ise RunInstallerAttributefalse, yardımcı programı proje yükleyicisini yoksayar.

Örneği proje yükleyicinizin koleksiyonuna MessageQueueInstaller eklemeden önce veya ekledikten sonra örneğin Installers diğer özelliklerini değiştirirsiniz. Örneğin, yükleme yardımcı programı yürütülmeden önce bir kuyruğun Path ayarlanması gerekir.

Genellikle, kodunuz içinden yöntemini MessageQueueInstaller çağırmazsınız; bunlar genellikle yalnızca installutil.exe yükleme yardımcı programı tarafından çağrılır. Yardımcı programı, yükleme işlemi sırasında yöntemini otomatik olarak çağırır Install ve yükleme özel durum oluşturmadıysa öğesini çağırır Commit . Gerekirse, özel durumu oluşturan nesneyi çağırarak Rollback hataları geri alır.

Uygulamanın yükleme yordamı, zaten yüklenmiş bileşenlerle ilgili bilgileri otomatik olarak korumak için proje yükleyicisini Installer.Context kullanır. Her MessageQueueInstaller örnek yardımcı program tarafından yüklendikçe bu durum bilgileri sürekli olarak güncelleştirilir. Kodunuzun durum bilgilerini açıkça değiştirmesi genellikle gerekli değildir.

Oluşturucular

MessageQueueInstaller()	MessageQueueInstaller sınıfının yeni bir örneğini başlatır. Hiçbir örnek özelliği ayarlamaz.
MessageQueueInstaller(MessageQueue)	Sınıfın MessageQueueInstaller yeni bir örneğini başlatır ve yükleme ayarlarını mevcut MessageQueue bir örneğinkilere başlatır.

Özellikler

Authenticate	Yüklenecek kuyruğun yalnızca kimliği doğrulanmış iletileri kabul edip etmediğini belirten bir değer alır veya ayarlar.
BasePriority	Genel kuyruğun iletilerini ağ üzerinden yönlendirmek için kullanılan temel önceliği alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Category	Uygulamaya özgü kuyruk türünü alır veya ayarlar.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
Context	Geçerli yüklemeyle ilgili bilgileri alır veya ayarlar. (Devralındığı yer: Installer)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
EncryptionRequired	Kuyruğun yalnızca özel veya şifrelenmiş iletileri kabul edip etmediğini belirten bir değer alır veya ayarlar.
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
HelpText	Yükleyici koleksiyonundaki tüm yükleyiciler için yardım metnini alır. (Devralındığı yer: Installer)
Installers	Bu yükleyicinin içerdiği yükleyici koleksiyonunu alır. (Devralındığı yer: Installer)
Label	Kuyruğun açıklamasını alır veya ayarlar.
MaximumJournalSize	Kuyrukla ilişkili günlüğün en büyük boyutunu alır veya ayarlar.
MaximumQueueSize	Kuyruğun en büyük boyutunu alır veya ayarlar.
MulticastAddress	MSMQ 3.0'da kullanıma sunulmuştur. Kuyrukla ilişkili çok noktaya yayın adresini alır veya ayarlar.
Parent	Bu yükleyicinin ait olduğu koleksiyonu içeren yükleyiciyi alır veya ayarlar. (Devralındığı yer: Installer)
Path	Bu nesne tarafından başvuruda bulunan kuyruğun konumunu alır veya ayarlar.
Permissions	Kuyrukla ilişkili izinleri alır veya ayarlar.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
Transactional	Kuyruğun yalnızca bir işlemin parçası olarak gönderilen iletileri kabul edip etmediğini belirten bir değer alır veya ayarlar.
UninstallAction	Yükleyicinin kaldırma sırasında kuyrukla ne yaptığını gösteren bir değer alır veya ayarlar: kaldırma, yükleme öncesi durumuna geri yükleme veya geçerli yüklü durumunda bırakma.
UseJournalQueue	Kuyruktan alınan iletilerin de ilişkili günlük kuyruğuna kopyalanıp kopyalanmayacağını belirten bir değer alır veya ayarlar.

Yöntemler

Commit(IDictionary)	Yöntemin kayıt defterine MessageQueue yazdığı yükleme bilgilerini Install(IDictionary) işleyerek yükleme işlemini tamamlar. Bu yöntemin, uygun yöntemleri otomatik olarak çağıran yükleme araçları tarafından kullanılması amaçlanır.
CopyFromComponent(IComponent)	Bir ileti kuyruğu için yükleme zamanında gerekli olan bileşenin MessageQueue özellik değerlerini kopyalar.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
Install(IDictionary)	Yüklemeyi gerçekleştirir ve ileti kuyruğu bilgilerini kayıt defterine yazar. Bu yöntemin, uygun yöntemleri otomatik olarak çağıran yükleme araçları tarafından kullanılması amaçlanır.
IsEquivalentInstaller(ComponentInstaller)	Belirtilen yükleyicinin bu yükleyiciyle aynı yükleme türünü işleyip işleyemeyeceğini belirler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnAfterInstall(IDictionary)	Olayı tetikler AfterInstall . (Devralındığı yer: Installer)
OnAfterRollback(IDictionary)	Olayı tetikler AfterRollback . (Devralındığı yer: Installer)
OnAfterUninstall(IDictionary)	Olayı tetikler AfterUninstall . (Devralındığı yer: Installer)
OnBeforeInstall(IDictionary)	Olayı tetikler BeforeInstall . (Devralındığı yer: Installer)
OnBeforeRollback(IDictionary)	Olayı tetikler BeforeRollback . (Devralındığı yer: Installer)
OnBeforeUninstall(IDictionary)	Olayı tetikler BeforeUninstall . (Devralındığı yer: Installer)
OnCommitted(IDictionary)	Olayı tetikler Committed . (Devralındığı yer: Installer)
OnCommitting(IDictionary)	Olayı tetikler Committing . (Devralındığı yer: Installer)
Rollback(IDictionary)	Yükleme yordamının kayıt defterine yazdığı kuyruk bilgilerini geri alarak bilgisayarı yüklemeden önceki durumuna geri yükler. Bu yöntemin, uygun yöntemleri otomatik olarak çağıran yükleme araçları tarafından kullanılması amaçlanır.
ToString()	Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)
Uninstall(IDictionary)	Kayıt defterinden kuyruk bilgilerini kaldırarak yüklemeyi kaldırır. Bu yöntemin, uygun yöntemleri otomatik olarak çağıran kaldırma araçları tarafından kullanılması amaçlanır.

Ekinlikler

AfterInstall	özelliğindeki Install(IDictionary) tüm yükleyicilerin Installers yöntemleri çalıştırıldıktan sonra gerçekleşir. (Devralındığı yer: Installer)
AfterRollback	özelliğindeki tüm yükleyicilerin yüklemeleri Installers geri alındıktan sonra gerçekleşir. (Devralındığı yer: Installer)
AfterUninstall	özelliğindeki tüm yükleyiciler Installers kaldırma işlemlerini gerçekleştirdikten sonra gerçekleşir. (Devralındığı yer: Installer)
BeforeInstall	Yükleyici koleksiyonundaki Install(IDictionary) her yükleyicinin yöntemi çalışmadan önce gerçekleşir. (Devralındığı yer: Installer)
BeforeRollback	özelliğindeki Installers yükleyiciler geri almadan önce gerçekleşir. (Devralındığı yer: Installer)
BeforeUninstall	özelliğindeki Installers yükleyiciler kaldırma işlemlerini gerçekleştirmeden önce gerçekleşir. (Devralındığı yer: Installer)
Committed	özelliğindeki Installers tüm yükleyiciler yüklemelerini işledikten sonra gerçekleşir. (Devralındığı yer: Installer)
Committing	özelliğindeki Installers yükleyiciler yüklemelerini işlemeden önce gerçekleşir. (Devralındığı yer: Installer)
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)

Ayrıca bkz.

• Installutil.exe (Yükleyici Aracı)