Compartilhar via


SystemConditionType Enumeração

Definição

Especifica uma condição do sistema que deve estar em vigor para que uma tarefa em segundo plano seja executada. Se uma tarefa em segundo plano com uma condição do sistema for disparada, a tarefa não será executada até que a condição seja atendida.

public enum class SystemConditionType
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class SystemConditionType
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum SystemConditionType
var value = Windows.ApplicationModel.Background.SystemConditionType.invalid
Public Enum SystemConditionType
Herança
SystemConditionType
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Campos

BackgroundWorkCostNotHigh 8

Especifica que a tarefa em segundo plano só pode ser executada quando o custo para fazer o trabalho em segundo plano é baixo.

FreeNetworkAvailable 7

Especifica que a tarefa em segundo plano só pode ser executada quando uma conexão de rede gratuita (não limitada) está disponível.

InternetAvailable 3

Especifica que a tarefa em segundo plano só pode ser executada quando a Internet está disponível. Se uma tarefa em segundo plano com a condição InternetAvailable for disparada e a Internet não estiver disponível, a tarefa não será executada até que a Internet esteja disponível novamente. Essa condição economiza energia, pois a tarefa em segundo plano não é executada até a rede estar disponível. Essa condição não fornece ativação em tempo real.

Importante

Defina IsNetworkRequested em sua tarefa em segundo plano para garantir que a rede permaneça ativa enquanto a tarefa em segundo plano é executada. Isso informa à infraestrutura de tarefas em segundo plano para manter a rede ativa enquanto a tarefa está em execução, mesmo que o dispositivo tenha entrado no modo de espera conectado, para que você possa chamar as APIs de rede principais (HttpClient, StreamSocket, DatagramSocket etc.) Se sua tarefa em segundo plano não definir IsNetworkRequested, sua tarefa em segundo plano não poderá acessar a rede quando estiver no modo de Espera Conectada (por exemplo, quando a tela de um telefone estiver desativada).)

InternetNotAvailable 4

Especifica que a tarefa em segundo plano só pode ser executada quando a Internet não está disponível. Se uma tarefa em segundo plano com a condição InternetNotAvailable for disparada e a Internet estiver disponível, a tarefa não será executada até que a Internet não esteja disponível.

Invalid 0

Não é um tipo de condição válido.

SessionConnected 5

Especifica que a tarefa em segundo plano só pode ser executada quando a sessão do usuário está conectada. Se uma tarefa em segundo plano com a condição SessionConnected for disparada e a sessão do usuário não estiver conectada, a tarefa será executada quando o usuário fizer logon.

SessionDisconnected 6

Especifica que a tarefa em segundo plano só pode ser executada quando a sessão do usuário é desconectada. Se uma tarefa em segundo plano com a condição SessionDisconnected for disparada e o usuário estiver conectado, a tarefa será executada quando o usuário desconectar a sessão de área de trabalho remota ou fizer uma troca> rápida de usuário [! OBSERVAÇÃO]

SessionDisconnected é usado principalmente no contexto da área de trabalho remota e da troca rápida de usuários. Ele não deve ser usado como uma notificação de que o usuário fez logoff do computador.

UserNotPresent 2

Especifica que a tarefa em segundo plano só pode ser executada quando o usuário não está presente. Se uma tarefa em segundo plano com a condição UserNotPresent for disparada e o usuário estiver presente, a tarefa não será executada até que o usuário fique inativo.

UserPresent 1

Especifica que a tarefa em segundo plano só pode ser executada quando o usuário estiver presente. Se uma tarefa em segundo plano com a condição UserPresent for disparada e o usuário estiver ausente, a tarefa não será executada até que o usuário esteja presente.

Aplica-se a

Confira também