ServiceInstaller.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입니다.
예외
설치에 실행 파일에 대한 ServiceProcessInstaller가 포함되어 있지 않은 경우
또는
어셈블리의 파일 이름이 null이거나 빈 문자열인 경우
또는 서비스 이름이 잘못된 경우
또는 서비스 컨트롤 관리자를 열지 못한 경우
서비스에 대한 표시 이름이 255자보다 긴 경우
설명
메서드를 호출 하는 되는 일반적으로 ServiceInstaller 코드 내에서 일반적으로 라고 설치 유틸리티에서만 합니다. 설치 유틸리티를 자동으로 호출 된 Install 설치 하는 동안 메서드. 원하는를 필요한 경우 호출 하 여 Rollback 에서 예외를 생성 하는 개체입니다.
이미 설치 되어 있는, 프로젝트 설치 관리자를 사용 하 여 구성 요소가 자동으로 정보를 유지 하는 애플리케이션의 설치 루틴 Installer.Context합니다. 이 상태 정보를 전달할 Install 으로 stateSaver 매개 변수는 지속적으로 업데이트 합니다 ServiceProcessInstaller 인스턴스 및 각 ServiceInstaller 인스턴스가 유틸리티에 의해 설치 된. 일반적으로이 상태 정보를 명시적으로 수정 하기 위해 코드에 대 한 필요는 없습니다.
합니다 ServiceProcessInstaller 관련 된 설치 클래스 설치 프로젝트 정보 모두에 공통적으로 적용 ServiceInstaller 프로젝트의 인스턴스. 이 서비스는 설치 프로젝트의 다른 서비스에서 구분 하는 모든 항목에 해당 서비스 관련 정보는이 메서드에 의해 설치 됩니다.
서비스를 설치 하려면에서 상속 되는 프로젝트 설치 관리자 클래스를 만듭니다는 Installer 클래스를 설정 합니다 RunInstallerAttribute 클래스를 특성 true합니다. 프로젝트 내에서 하나를 만들 ServiceProcessInstaller 서비스 애플리케이션을 이전과 인스턴스당 ServiceInstaller 애플리케이션에서 각 서비스에 대 한 인스턴스. 프로젝트 설치 관리자 클래스 생성자를 사용 하 여 서비스에 대 한 설치 속성을 설정 합니다 ServiceProcessInstaller 하 고 ServiceInstaller 인스턴스와 인스턴스를 추가할는 Installers 컬렉션.
참고
설치 관리자 인스턴스를 추가 하는 것에 대 한 생성자를 사용 하는 것이 좋습니다. 그러나에 추가 해야 할 경우는 Installers 컬렉션에는 Install 메서드를 컬렉션에 동일한 추가 수행 해야 합니다 Uninstall 메서드.
파생 된 모든 클래스에 대 한 합니다 Installer 클래스의 상태는 Installers 컬렉션에서 동일 해야 합니다 Install 및 Uninstall 메서드. 그러나 컬렉션을 유지 관리를 방지할 수 있습니다 합니다 Install 및 Uninstall 설치 관리자 인스턴스를 추가 하는 경우 메서드는 Installers 사용자 지정 설치 관리자 클래스 생성자 컬렉션입니다.