<entryPoint> , element (aplikacja ClickOnce)

  • Artykuł

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>

Zobacz też