StartupTask Classe

Definizione

public ref class StartupTask sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.StartupTaskContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StartupTask final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.StartupTaskContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StartupTask

Public NotInheritable Class StartupTask

Ereditarietà

Object Platform::Object IInspectable StartupTask

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Commenti

Questa funzionalità è supportata nelle versioni desktop di Windows in applicazioni UWP e desktop in un pacchetto di app Windows. Per altre informazioni sulle applicazioni desktop in pacchetto (note anche come app Desktop Bridge), vedere Pacchetti di applicazioni desktop. Il supporto per le applicazioni desktop in pacchetto è stato introdotto nell'aggiornamento Windows 10 anniversario (versione 1607) e per le app UWP nel Windows 10 Fall Creators Update (versione 1709).

Un'app deve aggiungere la categoria di estensione al manifesto del windows.startup pacchetto dell'app per essere attivata all'avvio o quando l'utente accede. L'aggiunta di questa estensione non comporterà automaticamente l'avvio dell'app.

Le app UWP devono chiamare RequestEnableAsync da un thread dell'interfaccia utente per attivare una finestra di dialogo di consenso utente. Se l'utente ha il consenso, l'app UWP inizierà quindi all'avvio o all'accesso dell'utente. Si noti che le app di avvio UWP inizieranno a ridurre al minimo.

Se RequestEnableAsync viene chiamato da un'app desktop in pacchetto, non viene visualizzata alcuna finestra di dialogo di consenso utente. Le app desktop possono impostare le attività di avvio su Abilitato nel manifesto, in tal caso non devono chiamare RequestEnableAsync.

In entrambi i casi, per abilitare la funzionalità di avvio, l'utente deve avviare l'app almeno una volta oppure deve abilitare la funzionalità di avvio per l'app nella pagina Di avvio in Impostazioni. Dopo aver abilitato, l'utente è in controllo e può modificare lo stato abilitato dell'app in qualsiasi momento tramite la pagina Di avvio in Impostazioni o la scheda Avvio in Gestione attività.

La dichiarazione di estensione seguente viene inserita nel manifesto del pacchetto dell'app. La dichiarazione usata dipende dal fatto che l'attività di avvio sia un'attività in background dell'app UWP o dell'app desktop.

Estensione dell'attività di avvio dell'app desktop in pacchetto

<Package xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5"...>
...
<Applications>
    <Application ...>
        ...
        <Extensions>
          <uap5:Extension
            Category="windows.startupTask"
            Executable="MyDesktopApp.exe"
            EntryPoint="Windows.FullTrustApplication">
            <uap5:StartupTask
              TaskId="MyStartupId"
              Enabled="false"
              DisplayName="My Desktop App" />
          </uap5:Extension>
        </Extensions>
    </Application>
</Applications>

Per le app desktop in pacchetto, sono consentite più estensioni startupTask e ognuna può specificare un eseguibile diverso.

Estensione dell'attività di avvio app UWP

<Package xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5" ...>
...
<Applications>
    <Application ...>
        ...
        <Extensions>
          <uap5:Extension Category="windows.startupTask">
            <uap5:StartupTask
              TaskId="MyStartupId"
              Enabled="false"
              DisplayName="Test startup" />
          </uap5:Extension>
      </Extensions>
    </Application>
</Applications>

Le app UWP devono avere una sola voce eseguibile e un'estensione windows.startupTask .
L'estensione windows.startupTask è disponibile solo per le app UWP eseguite in Windows Desktop.

Estensione dell'attività di avvio di Windows Web App (WWA)

<Package xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5" .m..>
...
<Applications>
    <Application ...>
        ...
        <Extensions>
          <uap5:Extension Category="windows.startupTask" StartPage="EntryPage">
            <uap5:StartupTask
              TaskId="MyStartupId"
              DisplayName="Test startup"/>
          </uap5:Extension>
      </Extensions>
    </Application>
</Applications>

Per le app WWA, eseguibili, EntryPoint e Abilita vengono ignorate e potrebbero essere mancanti o null.

Esempio

Il codice seguente crea un startupTask:

StartupTask startupTask = await StartupTask.GetAsync("MyStartupId"); // Pass the task ID you specified in the appxmanifest file
switch (startupTask.State)
{
    case StartupTaskState.Disabled:
        // Task is disabled but can be enabled.
        StartupTaskState newState = await startupTask.RequestEnableAsync(); // ensure that you are on a UI thread when you call RequestEnableAsync()
        Debug.WriteLine("Request to enable startup, result = {0}", newState);
        break;
    case StartupTaskState.DisabledByUser:
        // Task is disabled and user must enable it manually.
        MessageDialog dialog = new MessageDialog(
            "You have disabled this app's ability to run " +
            "as soon as you sign in, but if you change your mind, " +
            "you can enable this in the Startup tab in Task Manager.",
            "TestStartup");
        await dialog.ShowAsync();
        break;
    case StartupTaskState.DisabledByPolicy:
        Debug.WriteLine("Startup disabled by group policy, or not supported on this device");
        break;
    case StartupTaskState.Enabled:
        Debug.WriteLine("Startup is enabled.");
        break;
}

Proprietà

Metodi

Si applica a

Vedi anche

• Esempio di codice dell'app di avvio
• Configurare l'app per iniziare all'accesso