<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 元素具有下列特性。

特性

说明

name

可选。 .NET Framework 不使用此值。

entryPoint 具有下列元素。

assemblyIdentity

必选。 assemblyIdentity 及其特性的作用在 <assemblyIdentity> 元素(ClickOnce 应用程序)中定义。

此元素的 processorArchitecture 特性与应用程序清单中其他地方的 assemblyIdentity 中定义的 processorArchitecture 特性必须匹配。

commandLine

必选。 必须是 entryPoint 元素的子元素。 它不包含任何子元素,但具有下列特性。

特性

说明

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 应用程序清单