<entryPoint> 요소(ClickOnce 애플리케이션)

  • 아티클

이 ClickOnce 애플리케이션이 클라이언트 컴퓨터에서 실행될 때 실행되어야 하는 어셈블리를 식별합니다.

구문

<entryPoint
   name
>
   <assemblyIdentity
      name
      version
      processorArchitecture
      language
   />
   <commandLine
      file
      parameters
   />
   <customHostRequired />
   <customUX />
</entryPoint>

요소 및 특성

entryPoint 요소는 필수이며 urn:schemas-microsoft-com:asm.v2 네임스페이스에 있습니다. 하나의 애플리케이션 매니페스트에는 하나의 entryPoint 요소만 정의될 수 있습니다.

entryPoint 요소에는 다음 특성이 있습니다.

attribute 설명
name 선택 사항입니다. .NET Framework에서는 이 값이 사용되지 않습니다.

entryPoint 에는 다음 요소가 있습니다.

assemblyIdentity

필수입니다. assemblyIdentity의 역할과 해당 특성은 <assemblyIdentity> 요소에 정의되어 있습니다.

이 요소의 processorArchitecture 특성과 애플리케이션 매니페스트의 다른 위치에 있는 assemblyIdentity에 정의된 processorArchitecture 특성은 일치해야 합니다.

commandLine

필수입니다. entryPoint 요소의 자식 요소여야 합니다. 자식 요소가 없으며 다음 특성이 있습니다.

attribute Description
file 필수입니다. ClickOnce 애플리케이션의 시작 어셈블리에 대한 로컬 참조입니다. 이 값에는 슬래시(/) 또는 백슬래시(\) 경로 구분 기호가 포함될 수 없습니다.
parameters 필수입니다. 진입점을 사용하여 수행할 작업을 설명합니다. 유일하게 유효한 값은 run입니다. 빈 문자열을 제공하면 run이라고 가정합니다.

customHostRequired

선택 사항. 포함된 경우 사용자 지정 호스트 내에서 배포되며 독립 실행형 애플리케이션이 아닌 구성 요소가 이 배포에 포함되도록 지정합니다.

이 요소가 있으면 assemblyIdentity 및 commandLine 요소는 없어야 합니다. 있으면 설치 중에 ClickOnce 유효성 검사 오류가 발생합니다.

이 요소에는 특성 및 자식 요소가 없습니다.

customUX

선택 사항. 애플리케이션이 사용자 지정 설치 프로그램을 통해 설치 및 유지 관리되며 시작 메뉴 항목, 바로 가기 또는 프로그램 추가/제거 항목을 만들지 않도록 지정합니다.

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

customUX 요소가 포함된 애플리케이션은 InPlaceHostingManager 클래스를 사용하여 설치 작업을 수행하는 사용자 지정 설치 프로그램을 제공해야 합니다. 이 요소가 포함된 애플리케이션은 해당 매니페스트 또는 setup.exe 필수 구성 요소 부트스트래퍼를 두 번 클릭하여 설치할 수 없습니다. 사용자 지정 설치 프로그램은 시작 메뉴 항목, 바로 가기, 프로그램 추가/제거 항목을 만들 수 있습니다. 사용자 지정 설치 프로그램이 프로그램 추가/제거 항목을 만들지 않는 경우 SubscriptionIdentity 속성에서 제공하는 구독 식별자를 저장하고 사용자가 나중에 UninstallCustomUXApplication 메서드를 호출하여 애플리케이션을 제거할 수 있도록 해야 합니다. 자세한 내용은 연습: ClickOnce 애플리케이션에 대한 사용자 지정 설치 프로그램 만들기를 참조하세요.

설명

이 요소는 ClickOnce 애플리케이션의 어셈블리 및 진입점을 식별합니다.

런타임에 commandLine을 사용하여 애플리케이션에 매개 변수를 전달할 수 없습니다. 애플리케이션의 AppDomain에서 ClickOnce 배포의 쿼리 문자열 매개 변수에 액세스할 수 있습니다. 자세한 내용은 방법: 온라인 ClickOnce 애플리케이션에서 쿼리 문자열 정보 검색을 참조하세요.

예시

다음 코드 예제에서는 ClickOnce 애플리케이션에 대한 애플리케이션 매니페스트의 entryPoint 요소를 보여 줍니다. 이 코드 예제는 ClickOnce 애플리케이션 매니페스트 항목에 제공된 더 큰 예제의 일부입니다.

<!-- Identify the main code entrypoint. -->
<!-- This code runs the main method in an executable assembly. -->
  <entryPoint>
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>

참고 항목