<entryPoint> Element (ClickOnce Application)
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2019. Download it here
Identifies the assembly that should be executed when this ClickOnce application is run on a client computer.
<entryPoint name > <assemblyIdentity name version processorArchitecture language /> <commandLine file parameters /> <customHostRequired /> <customUX /> </entryPoint>
Elements and Attributes
entryPoint element is required and is in the
urn:schemas-microsoft-com:asm.v2 namespace. There may only be one
entryPoint element defined in an application manifest.
entryPoint element has the following attribute.
||Optional. This value is not used by .NET Framework.|
entryPoint has the following elements.
Required. The role of
assemblyIdentity and its attributes is defined in <assemblyIdentity> Element.
processorArchitecture attribute of this element and the
processorArchitecture attribute defined in the
assemblyIdentity elsewhere in the application manifest must match.
Required. Must be a child of the
entryPoint element. It has no child elements and has the following attributes.
||Required. A local reference to the startup assembly for the ClickOnce application. This value cannot contain forward slash (/) or backslash (\) path separators.|
||Required. Describes the action to take with the entry point. The only valid value is
Optional. If included, specifies that this deployment contains a component that will be deployed inside of a custom host, and is not a stand-alone application.
If this element is present, the
commandLine elements must not also be present. If they are, ClickOnce will raise a validation error during installation.
This element has no attributes and no children.
Optional. Specifies that the application is installed and maintained by a custom installer, and does not create a Start menu entry, shortcut, or Add or Remove Programs entry.
<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />
An application that includes the customUX element must provide a custom installer that uses the InPlaceHostingManager class to perform install operations. An application with this element cannot be installed by double-clicking its manifest or setup.exe prerequisite bootstrapper. The custom installer can create Start menu entries, shortcuts, and Add or Remove Programs entries. If the custom installer does not create an Add or Remove Programs entry, it must store the subscription identifier provided by the SubscriptionIdentity property and enable the user to uninstall the application later by calling the UninstallCustomUXApplication method. For more information, see Walkthrough: Creating a Custom Installer for a ClickOnce Application.
This element identifies the assembly and entry point for the ClickOnce application.
You cannot use
commandLine to pass parameters into your application at run time. You can access query string parameters for a ClickOnce deployment from the application's AppDomain. For more information, see How to: Retrieve Query String Information in an Online ClickOnce Application.
The following code example illustrates an
entryPoint element in an application manifest for a ClickOnce application. This code example is part of a larger example provided for the ClickOnce Application Manifest topic.
<!-- Identify the main code entrypoint. --> <!-- This code runs the main method in an executable assembly. --> <entryPoint> <assemblyIdentity name="MyApplication" version="220.127.116.11" language="neutral" processorArchitecture="x86" /> <commandLine file="MyApplication.exe" parameters="" /> </entryPoint>