<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 項目具有下列屬性。

屬性	描述
`name`	選擇性。 .NET Framework 不會使用此值。

entryPoint 具有下列項目。

assemblyIdentity

必要。 assemblyIdentity 的角色及其屬性是定義於 <assemblyIdentity> 元素。

此元素的 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 部署的查詢字串參數。如需詳細資訊，請參閱 How to: Retrieve query string information in an online ClickOnce application (如何：在線上 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 應用程式資訊清單