Udostępnij za pośrednictwem


MessageQueueInstaller Klasa

Definicja

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

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()
Przestarzałe.

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()
Przestarzałe.

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)

Dotyczy

Zobacz też