Compartilhar via


PackageDependency.Add Método

Definição

Sobrecargas

Add()

Adiciona uma referência em tempo de execução para a dependência do pacote de estrutura que você criou anteriormente usando o método Create . Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote de estrutura.

Add(AddPackageDependencyOptions)

Adiciona uma referência em tempo de execução para a dependência do pacote de estrutura que você criou anteriormente usando o método Create , com as opções especificadas. Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote de estrutura.

Add()

Adiciona uma referência em tempo de execução para a dependência do pacote de estrutura que você criou anteriormente usando o método Create . Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote de estrutura.

public:
 virtual PackageDependencyContext ^ Add() = Add;
/// [Windows.Foundation.Metadata.Overload("Add")]
PackageDependencyContext Add();
[Windows.Foundation.Metadata.Overload("Add")]
public PackageDependencyContext Add();
function add()
Public Function Add () As PackageDependencyContext

Retornos

Um objeto que fornece informações de contexto sobre a dependência do pacote de estrutura e permite que você remova a referência em tempo de execução.

Atributos

Comentários

Chamar esse método resolve a dependência do pacote de estrutura para um pacote específico no sistema. Ele também informa ao sistema operacional que o pacote de estrutura está em uso ativo e para lidar com as atualizações de versão lado a lado (atrasar efetivamente a desinstalação ou, de outra forma, a manutenção da versão mais antiga até que seu aplicativo termine de usá-la). A resolução de pacotes é específica para um usuário e pode retornar valores diferentes para usuários diferentes em um sistema.

Cada chamada de Adição bem-sucedida adiciona o pacote resolvido ao grafo de pacote do processo de chamada, mesmo que já esteja presente. Não há nenhuma detecção ou filtragem duplicada aplicada pela API (ou seja, várias referências de um pacote não são prejudiciais). Após a conclusão da resolução, a dependência do pacote permanece resolvida para esse usuário até que a última referência em todos os processos desse usuário seja removida por meio de PackageDependencyContext.Remove ou o processo seja encerrado. Chamadas bem-sucedidas para esse método alteram o valor PackageDependency.GenerationId .

Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote de estrutura até PackageDependencyContext.Remove ser chamado.

Se vários pacotes estiverem presentes no grafo de pacotes com a mesma classificação que a chamada para Adicionar, o pacote resolvido será adicionado após outros da mesma classificação.

Para obter mais informações, consulte Usar a API de dependência dinâmica para referenciar pacotes MSIX em tempo de execução.

Confira também

Aplica-se a

Add(AddPackageDependencyOptions)

Adiciona uma referência em tempo de execução para a dependência do pacote de estrutura que você criou anteriormente usando o método Create , com as opções especificadas. Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote de estrutura.

public:
 virtual PackageDependencyContext ^ Add(AddPackageDependencyOptions ^ options) = Add;
/// [Windows.Foundation.Metadata.Overload("Add2")]
PackageDependencyContext Add(AddPackageDependencyOptions const& options);
[Windows.Foundation.Metadata.Overload("Add2")]
public PackageDependencyContext Add(AddPackageDependencyOptions options);
function add(options)
Public Function Add (options As AddPackageDependencyOptions) As PackageDependencyContext

Parâmetros

options
AddPackageDependencyOptions

Define opções adicionais para especificar a referência do pacote de estrutura.

Retornos

Um objeto que fornece informações de contexto sobre a dependência do pacote de estrutura e permite que você remova a referência em tempo de execução.

Atributos

Comentários

Chamar esse método resolve a dependência do pacote de estrutura para um pacote específico no sistema. Ele também informa ao sistema operacional que o pacote de estrutura está em uso ativo e para lidar com as atualizações de versão lado a lado (atrasar efetivamente a desinstalação ou, de outra forma, a manutenção da versão mais antiga até que seu aplicativo termine de usá-la). A resolução de pacotes é específica para um usuário e pode retornar valores diferentes para usuários diferentes em um sistema.

Cada chamada de Adição bem-sucedida adiciona o pacote resolvido ao grafo de pacote do processo de chamada, mesmo que já esteja presente. Não há nenhuma detecção ou filtragem duplicada aplicada pela API (ou seja, várias referências de um pacote não são prejudiciais). Após a conclusão da resolução, a dependência do pacote permanece resolvida para esse usuário até que a última referência em todos os processos desse usuário seja removida por meio de PackageDependencyContext.Remove ou o processo seja encerrado. Chamadas bem-sucedidas para esse método alteram o valor PackageDependency.GenerationId .

Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote de estrutura até PackageDependencyContext.Remove ser chamado.

Se vários pacotes estiverem presentes no grafo de pacotes com a mesma classificação que a chamada para Adicionar, o pacote resolvido será (por padrão) adicionado após outros da mesma classificação. Para adicionar um pacote antes de outros da mesma classificação, especifique PrependIfRankCollision para o parâmetro options .

Para obter mais informações, consulte Usar a API de dependência dinâmica para referenciar pacotes MSIX em tempo de execução.

Confira também

Aplica-se a