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

아티클
01/12/2024

이 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>

참고 항목

ClickOnce 애플리케이션 매니페스트

다음을 통해 공유