<entryPoint> , element (aplikacja ClickOnce)
Identyfikuje zestaw, który ma zostać wykonany po uruchomieniu tej aplikacji ClickOnce na komputerze klienckim.
Składnia
<entryPoint
name
>
<assemblyIdentity
name
version
processorArchitecture
language
/>
<commandLine
file
parameters
/>
<customHostRequired />
<customUX />
</entryPoint>
Elementy i atrybuty
Element entryPoint
jest wymagany i znajduje się w urn:schemas-microsoft-com:asm.v2
przestrzeni nazw. W manifeście aplikacji może być zdefiniowany tylko jeden entryPoint
element.
Element entryPoint
ma następujący atrybut.
Atrybut | opis |
---|---|
name |
Opcjonalny. Ta wartość nie jest używana przez program .NET Framework. |
entryPoint
zawiera następujące elementy.
Assemblyidentity
Wymagany. Rola atrybutów assemblyIdentity
i jej atrybutów jest definiowana w <elemektorze assemblyIdentity>.
Atrybut processorArchitecture
tego elementu i processorArchitecture
atrybut zdefiniowany w assemblyIdentity
innym miejscu w manifeście aplikacji musi być zgodny.
Commandline
Wymagany. Musi być elementem podrzędnym entryPoint
elementu. Nie ma żadnych elementów podrzędnych i ma następujące atrybuty.
Atrybut | opis |
---|---|
file |
Wymagane. Lokalne odwołanie do zestawu startowego dla aplikacji ClickOnce. Ta wartość nie może zawierać ukośnika ukośnika (/) ani separatorów ścieżek ukośnika odwrotnego (\). |
parameters |
Wymagany. Opisuje akcję do wykonania z punktem wejścia. Jedyną prawidłową wartością jest run ; jeśli podano pusty ciąg, run przyjmuje się założenie. |
customHostRequired
Opcjonalny. W przypadku dołączenia określa, że to wdrożenie zawiera składnik, który zostanie wdrożony wewnątrz hosta niestandardowego i nie jest aplikacją autonomiczną.
Jeśli ten element jest obecny, assemblyIdentity
elementy i commandLine
nie mogą być również obecne. Jeśli tak, funkcja ClickOnce zgłosi błąd weryfikacji podczas instalacji.
Ten element nie ma atrybutów i elementów podrzędnych.
customUX
Opcjonalny. Określa, że aplikacja jest instalowana i utrzymywana przez instalatora niestandardowego i nie tworzy wpisu menu Start, skrótu lub pozycji Dodaj lub Usuń programy.
<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />
Aplikacja, która zawiera element customUX, musi udostępnić instalator niestandardowy, który używa InPlaceHostingManager klasy do wykonywania operacji instalacji. Nie można zainstalować aplikacji z tym elementem przez dwukrotne kliknięcie manifestu lub instalatora.exe wstępne narzędzie inicjujące. Instalator niestandardowy może tworzyć wpisy menu Start, skróty i pozycje Dodaj lub Usuń programy. Jeśli instalator niestandardowy nie tworzy wpisu Dodaj lub Usuń programy, musi przechowywać identyfikator subskrypcji dostarczony przez SubscriptionIdentity właściwość i umożliwić użytkownikowi odinstalowanie aplikacji później przez wywołanie UninstallCustomUXApplication metody . Aby uzyskać więcej informacji, zobacz Przewodnik: tworzenie instalatora niestandardowego dla aplikacji ClickOnce.
Uwagi
Ten element identyfikuje zestaw i punkt wejścia dla aplikacji ClickOnce.
Nie można użyć commandLine
polecenia , aby przekazać parametry do aplikacji w czasie wykonywania. Dostęp do parametrów ciągu zapytania dla wdrożenia technologii ClickOnce można uzyskać z poziomu aplikacji AppDomain. Aby uzyskać więcej informacji, zobacz How to: Retrieve Query String Information in an Online ClickOnce Application (Instrukcje: pobieranie informacji o ciągu zapytania w aplikacji ClickOnce online).
Przykład
Poniższy przykład kodu ilustruje entryPoint
element w manifeście aplikacji dla aplikacji ClickOnce. Ten przykład kodu jest częścią większego przykładu podanego dla tematu Manifest aplikacji 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>