Elemento <entryPoint> (applicazione ClickOnce)

Articolo
02/18/2013

Identifica l'assembly che deve essere eseguito quando l'applicazione ClickOnce viene eseguita su un computer client.

<entryPoint
   name
>
   <assemblyIdentity
      name
      version
      processorArchitecture
      language
   />
   <commandLine
      file
      parameters
   />
   <customHostRequired />
   <customUX />
</entryPoint>

Elementi e attributi

L'elemento entryPoint è obbligatorio e si trova nello spazio dei nomi urn:schemas-microsoft-com:asm.v2.È possibile definire un solo elemento entryPoint in un manifesto dell'applicazione.

L'elemento entryPoint presenta l'attributo seguente.

Attributo	Descrizione
name	Parametro facoltativo.Questo valore non viene utilizzato da .NET Framework.

entryPoint presenta gli elementi seguenti.

assemblyIdentity

Obbligatorio.Il ruolo di assemblyIdentity e dei relativi attributi viene definito nell'Elemento <assemblyIdentity> (applicazione ClickOnce).

L'attributo processorArchitecture di questo elemento e l'attributo processorArchitecture definito nell'attributo assemblyIdentity in un'altra posizione nel manifesto dell'applicazione devono corrispondere.

commandLine

Obbligatorio.Deve essere un elemento figlio dell'elemento entryPoint.Non contiene elementi figlio e dispone degli attributi riportati di seguito.

Attributo	Descrizione
file	Obbligatorio.Riferimento locale all'assembly di avvio per l'applicazione ClickOnce.Questo valore non può contenere separatori di percorso barra (/) o barra rovesciata (\).
parameters	Obbligatorio.Descrive l'azione da eseguire con il punto di ingresso.L'unico valore valido è run. Se viene fornita una stringa vuota, si presuppone che venga utilizzato il valore run.

customHostRequired

Parametro facoltativo.Se incluso, specifica che questa distribuzione contiene un componente che sarà distribuito all'interno di un host personalizzato e non è un'applicazione autonoma.

Se questo elemento è presente, gli elementi assemblyIdentity e commandLine non possono essere presentialtrimenti ClickOnce genererà un errore di convalida durante l'installazione.

Questo elemento non ha né attributi né figli.

customUX

Parametro facoltativo.Specifica che l'applicazione viene installata e gestita da un programma di installazione personalizzato e non crea una voce del menu Start, un collegamento o un voce Installazione applicazioni.

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

Per eseguire le operazioni di installazione, un'applicazione che include l'elemento customUX deve fornire un programma di installazione personalizzato che utilizzi la classe InPlaceHostingManager.Impossibile installare un'applicazione con questo elemento facendo doppio clic sul manifesto o sul programma di avvio automatico dei prerequisiti setup.exe.Con il programma di installazione personalizzato è possibile creare voci del menu Start, collegamenti e voci Installazione applicazioni.Se il programma di installazione personalizzato non crea una voce Installazione applicazioni, deve archiviare l'identificatore di sottoscrizione fornito dalla proprietà SubscriptionIdentity e in seguito deve consentire all'utente di disinstallare l'applicazione chiamando il metodo UninstallCustomUXApplication.Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un programma di installazione personalizzato per un'applicazione ClickOnce.

Note

Questo elemento identifica l'assembly e il punto di ingresso per l'applicazione ClickOnce.

Non è possibile utilizzare l'elemento commandLine per passare i parametri all'applicazione in fase di esecuzione.È possibile accedere ai parametri della stringa di query per una distribuzione ClickOnce dall'oggetto AppDomain dell'applicazione.Per ulteriori informazioni, vedere Procedura: recuperare informazioni sulle stringhe di query in un'applicazione ClickOnce online.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato un elemento entryPoint in un manifesto per un'applicazione ClickOnce.L'esempio di codice fa parte di un esempio più esaustivo fornito per l'argomento Manifesto dell'applicazione 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>

Vedere anche

Riferimenti

Manifesto dell'applicazione ClickOnce

Condividi tramite