MessageQueueInstaller Klasa

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Umożliwia zainstalowanie i skonfigurowanie kolejki wymaganej przez aplikację do uruchomienia. Ta klasa jest wywoływana przez narzędzie instalacyjne, na przykład InstallUtil.exe podczas instalowania programu 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

Dziedziczenie

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Uwagi

Element MessageQueueInstaller jest używany przez narzędzie instalacyjne do zapisywania wartości rejestru skojarzonych z kolejką. Aby uzyskać więcej informacji na temat narzędzi instalacyjnych, zobacz Installutil.exe (Narzędzie instalatora).

Aby zainstalować kolejkę, utwórz klasę instalatora projektu, która dziedziczy z Installerklasy , i ustaw dla klasy wartość RunInstallerAttributetrue. W projekcie utwórz MessageQueueInstaller wystąpienie dla każdej kolejki w instalacji i dodaj wystąpienie do klasy instalatora projektu.

Podczas tworzenia MessageQueueInstaller wystąpienia można opcjonalnie przekazać istniejący MessageQueue (na przykład z serwera testowego) do konstruktora MessageQueueInstaller . Takie podejście automatycznie zapewnia ustawienia konfiguracji dla nowej kolejki przez dublowanie ustawień przekazanej kolejki. Alternatywnie można ręcznie ustawić właściwości w wystąpieniu MessageQueueInstaller na żądane stany i wywołać konstruktor bez parametrów.

Po wywołaniu narzędzia instalacyjnego program wyszukuje element RunInstallerAttribute. Jeśli jest trueto , narzędzie instaluje wszystkie kolejki w Installers kolekcji skojarzonej z instalatorem projektu. Jeśli RunInstallerAttribute parametr ma falsewartość , narzędzie ignoruje instalatora projektu.

Inne właściwości MessageQueueInstaller wystąpienia można modyfikować przed lub po dodaniu wystąpienia do Installers kolekcji instalatora projektu. Na przykład kolejka musi zostać ustawiona Path przed wykonaniem narzędzia instalacyjnego.

Zazwyczaj metody metody z wewnątrz kodu nie są wywoływane MessageQueueInstaller . Są one zwykle wywoływane tylko przez narzędzie instalacyjne installutil.exe. Narzędzie automatycznie wywołuje metodę Install podczas procesu instalacji i wywołuje Commit metodę, jeśli instalacja nie zgłosiła wyjątku. W razie potrzeby usuwa błędy, wywołując Rollback obiekt, który wygenerował wyjątek.

Procedura instalacji aplikacji używa instalatora Installer.Context projektu do automatycznego utrzymywania informacji o składnikach, które zostały już zainstalowane. Te informacje o stanie są stale aktualizowane, ponieważ każde MessageQueueInstaller wystąpienie jest instalowane przez narzędzie . Zwykle nie jest konieczne, aby kod jawnie zmodyfikował informacje o stanie.

Konstruktory

MessageQueueInstaller()	Inicjuje nowe wystąpienie klasy MessageQueueInstaller. Nie ustawia żadnych właściwości wystąpienia.
MessageQueueInstaller(MessageQueue)	Inicjuje MessageQueueInstaller nowe wystąpienie klasy, inicjując ustawienia instalacji do tych z istniejącego MessageQueue wystąpienia.

Właściwości

Authenticate	Pobiera lub ustawia wartość wskazującą, czy kolejka do zainstalowania akceptuje tylko uwierzytelnione komunikaty.
BasePriority	Pobiera lub ustawia priorytet podstawowy używany do kierowania komunikatów kolejki publicznej za pośrednictwem sieci.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Category	Pobiera lub ustawia typ kolejki specyficznej dla implementacji.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
Context	Pobiera lub ustawia informacje o bieżącej instalacji. (Odziedziczone po Installer)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
EncryptionRequired	Pobiera lub ustawia wartość wskazującą, czy kolejka akceptuje tylko prywatne, czy zaszyfrowane komunikaty.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
HelpText	Pobiera tekst pomocy dla wszystkich instalatorów w kolekcji instalatora. (Odziedziczone po Installer)
Installers	Pobiera kolekcję instalatorów, które zawiera ten instalator. (Odziedziczone po Installer)
Label	Pobiera lub ustawia opis kolejki.
MaximumJournalSize	Pobiera lub ustawia maksymalny rozmiar dziennika skojarzonego z kolejką.
MaximumQueueSize	Pobiera lub ustawia maksymalny rozmiar kolejki.
MulticastAddress	Wprowadzono w programie MSMQ 3.0. Pobiera lub ustawia adres multiemisji skojarzony z kolejką.
Parent	Pobiera lub ustawia instalator zawierający kolekcję, do których należy ten instalator. (Odziedziczone po Installer)
Path	Pobiera lub ustawia lokalizację kolejki, do którego odwołuje się ten obiekt.
Permissions	Pobiera lub ustawia uprawnienia skojarzone z kolejką.
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
Transactional	Pobiera lub ustawia wartość wskazującą, czy kolejka akceptuje tylko komunikaty wysyłane w ramach transakcji.
UninstallAction	Pobiera lub ustawia wartość wskazującą, co instalator wykonuje z kolejką w czasie odinstalowywania: usuń ją, przywróć ją do stanu przed instalacją lub pozostaw ją w bieżącym stanie instalacji.
UseJournalQueue	Pobiera lub ustawia wartość wskazującą, czy komunikaty pobierane z kolejki są również kopiowane do skojarzonej kolejki dziennika.

Metody

Commit(IDictionary)	Kończy proces instalacji, zatwierdzając MessageQueue informacje o instalacji, które została zapisana Install(IDictionary) w rejestrze przez metodę . Ta metoda ma być używana przez narzędzia instalacyjne, które automatycznie nazywają odpowiednie metody.
CopyFromComponent(IComponent)	Kopiuje wartości MessageQueue właściwości składnika wymaganego w czasie instalacji kolejki komunikatów.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Install(IDictionary)	Wykonuje instalację i zapisuje informacje o kolejce komunikatów w rejestrze. Ta metoda ma być używana przez narzędzia instalacyjne, które automatycznie nazywają odpowiednie metody.
IsEquivalentInstaller(ComponentInstaller)	Określa, czy określony instalator może obsłużyć ten sam rodzaj instalacji co ten instalator.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnAfterInstall(IDictionary)	AfterInstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnAfterRollback(IDictionary)	AfterRollback Zgłasza zdarzenie. (Odziedziczone po Installer)
OnAfterUninstall(IDictionary)	AfterUninstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnBeforeInstall(IDictionary)	BeforeInstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnBeforeRollback(IDictionary)	BeforeRollback Zgłasza zdarzenie. (Odziedziczone po Installer)
OnBeforeUninstall(IDictionary)	BeforeUninstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnCommitted(IDictionary)	Committed Zgłasza zdarzenie. (Odziedziczone po Installer)
OnCommitting(IDictionary)	Committing Zgłasza zdarzenie. (Odziedziczone po Installer)
Rollback(IDictionary)	Przywraca komputer do stanu, w jaki znajdował się przed instalacją, przez wycofywanie informacji o kolejce, które procedura instalacji została zapisana w rejestrze. Ta metoda ma być używana przez narzędzia instalacyjne, które automatycznie nazywają odpowiednie metody.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
Uninstall(IDictionary)	Usuwa instalację przez usunięcie informacji o kolejce z rejestru. Ta metoda ma być używana przez narzędzia dezinstalacji, które automatycznie wywołuje odpowiednie metody.

Zdarzenia

AfterInstall	Występuje po uruchomieniu Install(IDictionary) metod wszystkich instalatorów we Installers właściwości . (Odziedziczone po Installer)
AfterRollback	Występuje po wycofaniu instalacji wszystkich instalatorów we Installers właściwości. (Odziedziczone po Installer)
AfterUninstall	Występuje po wykonaniu Installers operacji dezinstalacji przez wszystkich instalatorów we właściwości. (Odziedziczone po Installer)
BeforeInstall	Występuje przed uruchomieniem Install(IDictionary) metody każdego instalatora w kolekcji instalatora. (Odziedziczone po Installer)
BeforeRollback	Występuje przed wycofaniem instalatorów we Installers właściwości. (Odziedziczone po Installer)
BeforeUninstall	Występuje przed wykonaniem operacji dezinstalacji przez instalatorów we Installers właściwości. (Odziedziczone po Installer)
Committed	Występuje po zatwierdzeniu instalacji przez wszystkich instalatorów we Installers właściwości. (Odziedziczone po Installer)
Committing	Występuje przed zatwierdzeniem instalacji przez instalatorów we Installers właściwości. (Odziedziczone po Installer)
Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)

Zobacz też

• Installutil.exe (narzędzie instalatora)