<entryPoint> 項目 (ClickOnce 應用程式)

發行項
06/10/2015

識別當這個 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 應用程式資訊清單

共用方式為