MessageQueueInstaller 클래스

정의

애플리케이션을 실행하기 위해 필요한 큐를 설치하고 구성할 수 있습니다. 이 클래스는 설치 유틸리티(예: InstallUtil.exe)를 설치할 때 호출됩니다 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
상속

설명

설치 MessageQueueInstaller 유틸리티에서 큐와 연결된 레지스트리 값을 작성하는 데 사용됩니다. 설치 유틸리티에 대한 자세한 내용은 Installutil.exe(설치 관리자 도구)를 참조하세요.

큐를 설치하려면 해당 클래스에서 상속되는 프로젝트 설치 관리자 클래스를 Installer만들고 클래스에 대한 클래스를 RunInstallerAttribute.로 설정합니다true. 프로젝트 내에서 설치의 MessageQueueInstaller 각 큐에 대한 인스턴스를 만들고 프로젝트 설치 관리자 클래스에 인스턴스를 추가합니다.

인스턴스를 MessageQueueInstaller 만들 때 필요에 따라 기존 MessageQueue (예: 테스트 서버) MessageQueueInstaller 을 생성자에 전달할 수 있습니다. 이 방법은 전달된 큐의 설정을 미러링하여 새 큐에 대한 구성 설정을 자동으로 제공합니다. 또는 인스턴스의 속성을 MessageQueueInstaller 원하는 상태로 수동으로 설정하고 매개 변수가 없는 생성자를 호출할 수 있습니다.

설치 유틸리티가 호출 RunInstallerAttribute되면 . 이 경우 유틸리티는 true프로젝트 설치 관리자와 연결된 컬렉션의 Installers 모든 큐를 설치합니다. 이 RunInstallerAttribute경우 false 유틸리티는 프로젝트 설치 관리자를 무시합니다.

프로젝트 설치 관리자의 컬렉션에 인스턴스를 MessageQueueInstaller 추가하기 전이나 후에 인스턴스 Installers 의 다른 속성을 수정합니다. 예를 들어 설치 유틸리티가 실행되기 전에 큐 Path 를 설정해야 합니다.

일반적으로 코드 내에서의 메서드를 MessageQueueInstaller 호출하지 않습니다. 일반적으로 installutil.exe 설치 유틸리티에서만 호출됩니다. 유틸리티는 설치 프로세스 중에 메서드를 Install 자동으로 호출하고 설치에서 예외를 throw하지 않은 경우 호출 Commit 합니다. 필요한 경우 예외를 생성한 개체를 호출 Rollback 하여 오류를 백업합니다.

애플리케이션의 설치 루틴은 프로젝트 설치 관리자를 Installer.Context 사용하여 이미 설치된 구성 요소에 대한 정보를 자동으로 유지 관리합니다. 이 상태 정보는 각 MessageQueueInstaller 인스턴스가 유틸리티에 의해 설치될 때 지속적으로 업데이트됩니다. 일반적으로 코드에서 상태 정보를 명시적으로 수정할 필요는 없습니다.

생성자

Name Description
MessageQueueInstaller()

MessageQueueInstaller 클래스의 새 인스턴스를 초기화합니다. 인스턴스 속성을 설정하지 않습니다.

MessageQueueInstaller(MessageQueue)

클래스의 새 인스턴스를 MessageQueueInstaller 초기화하여 기존 MessageQueue 인스턴스의 설치 설정을 초기화합니다.

속성

Name Description
Authenticate

설치할 큐에서 인증된 메시지만 허용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

BasePriority

네트워크를 통해 공용 큐의 메시지를 라우팅하는 데 사용되는 기본 우선 순위를 가져오거나 설정합니다.

CanRaiseEvents

구성 요소가 이벤트를 발생시키는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 Component)
Category

구현별 큐 유형을 가져오거나 설정합니다.

Container

IContainer 포함하는 값을 가져옵니다 Component.

(다음에서 상속됨 Component)
Context

현재 설치에 대한 정보를 가져오거나 설정합니다.

(다음에서 상속됨 Installer)
DesignMode

현재 디자인 모드인지 여부를 Component 나타내는 값을 가져옵니다.

(다음에서 상속됨 Component)
EncryptionRequired

큐에서 프라이빗 또는 암호화된 메시지만 허용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

Events

Component에 연결된 이벤트 처리기 목록을 가져옵니다.

(다음에서 상속됨 Component)
HelpText

설치 관리자 컬렉션의 모든 설치 관리자에 대한 도움말 텍스트를 가져옵니다.

(다음에서 상속됨 Installer)
Installers

이 설치 관리자에 포함된 설치 관리자의 컬렉션을 가져옵니다.

(다음에서 상속됨 Installer)
Label

큐에 대한 설명을 가져오거나 설정합니다.

MaximumJournalSize

큐와 연결된 저널의 최대 크기를 가져오거나 설정합니다.

MaximumQueueSize

큐의 최대 크기를 가져오거나 설정합니다.

MulticastAddress

MSMQ 3.0에 도입되었습니다. 큐와 연결된 멀티캐스트 주소를 가져오거나 설정합니다.

Parent

이 설치 관리자가 속한 컬렉션을 포함하는 설치 관리자를 가져오거나 설정합니다.

(다음에서 상속됨 Installer)
Path

이 개체에서 참조하는 큐의 위치를 가져오거나 설정합니다.

Permissions

큐와 연결된 권한을 가져오거나 설정합니다.

Site

ISite를 가져오거나 Component의 값을 설정합니다.

(다음에서 상속됨 Component)
Transactional

큐가 트랜잭션의 일부로 보낸 메시지만 허용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

UninstallAction

설치 관리자가 제거 시 큐에서 수행하는 작업을 나타내는 값을 가져오거나 설정합니다. 제거하거나, 설치 전 상태로 복원하거나, 현재 설치된 상태로 둡니다.

UseJournalQueue

큐에서 검색된 메시지도 연결된 저널 큐에 복사되는지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

Name Description
Commit(IDictionary)

메서드가 레지스트리에 쓴 설치 정보를 MessageQueue 커밋 Install(IDictionary) 하여 설치 프로세스를 완료합니다. 이 메서드는 적절한 메서드를 자동으로 호출하는 설치 도구에서 사용됩니다.

CopyFromComponent(IComponent)

설치 시 메시지 큐에 MessageQueue 필요한 구성 요소의 속성 값을 복사합니다.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시를 생성하는 데 필요한 모든 관련 정보를 포함하는 개체를 만듭니다.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

에서 사용하는 모든 리소스를 Component해제합니다.

(다음에서 상속됨 Component)
Dispose(Boolean)

관리되지 않는 리소스를 Component 해제하고 관리되는 리소스를 선택적으로 해제합니다.

(다음에서 상속됨 Component)
Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 사용됩니다.

(다음에서 상속됨 Object)
GetLifetimeService()
사용되지 않음.

이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다.

(다음에서 상속됨 MarshalByRefObject)
GetService(Type)

또는 해당 서비스에서 제공하는 서비스를 나타내는 개체를 Component 반환합니다 Container.

(다음에서 상속됨 Component)
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
InitializeLifetimeService()
사용되지 않음.

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.

(다음에서 상속됨 MarshalByRefObject)
Install(IDictionary)

설치를 수행하고 레지스트리에 메시지 큐 정보를 씁니다. 이 메서드는 적절한 메서드를 자동으로 호출하는 설치 도구에서 사용됩니다.

IsEquivalentInstaller(ComponentInstaller)

지정된 설치 관리자가 이 설치 관리자와 동일한 종류의 설치를 처리할 수 있는지 여부를 결정합니다.

MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.

(다음에서 상속됨 MarshalByRefObject)
OnAfterInstall(IDictionary)

AfterInstall 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnAfterRollback(IDictionary)

AfterRollback 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnAfterUninstall(IDictionary)

AfterUninstall 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnBeforeInstall(IDictionary)

BeforeInstall 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnBeforeRollback(IDictionary)

BeforeRollback 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnBeforeUninstall(IDictionary)

BeforeUninstall 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnCommitted(IDictionary)

Committed 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
OnCommitting(IDictionary)

Committing 이벤트를 발생시킵니다.

(다음에서 상속됨 Installer)
Rollback(IDictionary)

설치 프로시저가 레지스트리에 쓴 큐 정보를 롤백하여 설치 전의 상태로 컴퓨터를 복원합니다. 이 메서드는 적절한 메서드를 자동으로 호출하는 설치 도구에서 사용됩니다.

ToString()

String(있는 경우)의 Component이름을 포함하는 값을 반환합니다. 이 메서드는 재정의해서는 안 됩니다.

(다음에서 상속됨 Component)
Uninstall(IDictionary)

레지스트리에서 큐 정보를 제거하여 설치를 제거합니다. 이 메서드는 자동으로 적절한 메서드를 호출하는 제거 도구에서 사용됩니다.

이벤트

Name Description
AfterInstall

속성에 있는 Install(IDictionary) 모든 설치 관리자의 메서드가 Installers 실행된 후에 발생합니다.

(다음에서 상속됨 Installer)
AfterRollback

속성에 있는 모든 설치 관리자 Installers 의 설치가 롤백된 후에 발생합니다.

(다음에서 상속됨 Installer)
AfterUninstall

속성의 모든 설치 관리자가 Installers 제거 작업을 수행한 후에 발생합니다.

(다음에서 상속됨 Installer)
BeforeInstall

설치 관리자 컬렉션의 Install(IDictionary) 각 설치 관리자 메서드가 실행되기 전에 발생합니다.

(다음에서 상속됨 Installer)
BeforeRollback

속성의 설치 관리자가 Installers 롤백되기 전에 발생합니다.

(다음에서 상속됨 Installer)
BeforeUninstall

속성의 설치 관리자가 Installers 제거 작업을 수행하기 전에 발생합니다.

(다음에서 상속됨 Installer)
Committed

속성의 모든 설치 관리자가 설치를 Installers 커밋한 후에 발생합니다.

(다음에서 상속됨 Installer)
Committing

속성의 설치 관리자가 설치를 Installers 커밋하기 전에 발생합니다.

(다음에서 상속됨 Installer)
Disposed

구성 요소가 메서드 호출에 Dispose() 의해 삭제될 때 발생합니다.

(다음에서 상속됨 Component)

적용 대상

추가 정보