MessageQueueInstaller.Install(IDictionary) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
설치를 수행하고 레지스트리에 메시지 큐 정보를 씁니다. 이 메서드는 적절한 메서드를 자동으로 호출하는 설치 도구에서 사용됩니다.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)매개 변수
- stateSaver
- IDictionary
IDictionary 커밋, 롤백 또는 제거 작업을 수행하는 데 필요한 정보를 저장하는 데 사용됩니다.
설명
이 메서드는 Install 레지스트리에 메시지 큐 정보를 쓰고 속성에 지정된 경로에 있는 큐에 인스턴스를 Path 연결 MessageQueue 합니다. 큐가 아직 없는 Install 경우 트랜잭션 큐를 만듭니다. Install 는 새 큐 또는 기존 큐 속성을 에 지정한 큐 속성으로 MessageQueueInstaller설정합니다. 큐가 이미 있는 경우 해당 속성은 해당 큐의 MessageQueueInstaller속성으로 다시 설정됩니다. 기존 큐가 트랜잭션이 아닌 경우 삭제된 다음 트랜잭션 큐로 다시 만듭니다.
주의
큐를 다시 만들어야 하는 경우 큐의 메시지가 손실됩니다.
일반적으로 코드 내에서의 메서드를 MessageQueueInstaller 호출하지 않습니다. 일반적으로 installutil.exe 설치 유틸리티에서만 호출됩니다. 이 유틸리티는 설치 프로세스 중에 자동으로 메서드를 호출 Install 하여 설치 중인 메시지 큐와 연결된 레지스트리 정보를 작성합니다. 설치는 트랜잭션이므로 설치 중에 설치 프로젝트 구성 요소가 실패하면 이전에 설치된 모든 구성 요소가 사전 설치 상태로 롤백됩니다. 이 작업은 각 구성 요소의 Rollback 메서드를 호출하여 수행됩니다.
설치 프로젝트와 연결된 모든 구성 요소를 성공적으로 설치한 후 설치 유틸리티는 설치를 커밋합니다. Commit 는 큐를 적절한 초기 상태로 설정하여 설치 MessageQueue 를 완료합니다. 속성에 지정된 큐가 Path 이미 있고 메시지를 Commit 포함하는 경우 메시지를 지웁니다. Commit Install메시지 제거 작업은 롤백할 수 없으므로 메시지를 지웁니다.
애플리케이션의 설치 루틴은 프로젝트 설치 관리자를 Installer.Context 사용하여 이미 설치된 구성 요소에 대한 정보를 자동으로 유지 관리합니다. 매개 변수로 stateSaver 전달 Install 되는 이 상태 정보는 유틸리티가 각 MessageQueueInstaller 인스턴스를 설치할 때 지속적으로 업데이트됩니다. 일반적으로 코드에서 이 상태 정보를 명시적으로 수정할 필요는 없습니다.
