PackageDependency.Add Метод

Определение

Пространство имен:

Microsoft.Windows.ApplicationModel.DynamicDependency

Перегрузки

Add()	Добавляет ссылку во время выполнения для зависимости пакета платформы, созданной ранее с помощью метода Create . После успешного возврата этого метода приложение может активировать типы и использовать содержимое из пакета платформы.
Add(AddPackageDependencyOptions)	Добавляет ссылку во время выполнения для зависимости пакета платформы, созданной ранее с помощью метода Create , с указанными параметрами. После успешного возврата этого метода приложение сможет активировать типы и использовать содержимое из пакета платформы.

Add()

Добавляет ссылку во время выполнения для зависимости пакета платформы, созданной ранее с помощью метода Create . После успешного возврата этого метода приложение может активировать типы и использовать содержимое из пакета платформы.

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

Возвращаемое значение

PackageDependencyContext

Объект , предоставляющий контекстную информацию о зависимости пакета платформы и позволяющий удалить ссылку во время выполнения.

Атрибуты

OverloadAttribute

Комментарии

Вызов этого метода разрешает зависимость пакета платформы для определенного пакета в системе. Он также информирует ОС о том, что пакет платформы активно используется и обрабатывает любые обновления версий параллельно (эффективно откладывает удаление или иным образом обслуживание старой версии до тех пор, пока приложение не будет готово к использованию). Разрешение пакетов зависит от пользователя и может возвращать разные значения для разных пользователей в системе.

Каждый успешный вызов Add добавляет разрешенный пакет в граф пакетов вызывающего процесса, даже если он уже присутствует. API не применяет обнаружение дубликатов или фильтрацию (то есть несколько ссылок из пакета не являются вредными). После завершения разрешения зависимость пакета остается разрешенной для этого пользователя, пока последняя ссылка во всех процессах этого пользователя не будет удалена через PackageDependencyContext.Remove или процесс не будет завершен. Успешные вызовы этого метода изменяют значение PackageDependency.GenerationId .

После успешного возврата этого метода приложение сможет активировать типы и использовать содержимое из пакета платформы до вызова PackageDependencyContext.Remove .

Если в графе пакетов присутствует несколько пакетов с тем же рангом, что и вызов Add, разрешенный пакет добавляется после других с тем же рангом.

Дополнительные сведения см. в статье Использование API динамических зависимостей для ссылки на пакеты MSIX во время выполнения.

См. также раздел

• Использование API динамических зависимостей для ссылки на пакеты MSIX во время выполнения

Add(AddPackageDependencyOptions)

Добавляет ссылку во время выполнения для зависимости пакета платформы, созданной ранее с помощью метода Create , с указанными параметрами. После успешного возврата этого метода приложение сможет активировать типы и использовать содержимое из пакета платформы.

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

Параметры

options

AddPackageDependencyOptions

Определяет дополнительные параметры для указания ссылки на пакет платформы.

Возвращаемое значение

PackageDependencyContext

Объект , предоставляющий контекстную информацию о зависимости пакета платформы и позволяющий удалить ссылку во время выполнения.

Атрибуты

OverloadAttribute

Комментарии

Вызов этого метода разрешает зависимость пакета платформы для определенного пакета в системе. Он также информирует ОС о том, что пакет платформы активно используется и обрабатывает любые обновления версий параллельно (эффективно откладывает удаление или иным образом обслуживание старой версии до тех пор, пока приложение не будет готово к использованию). Разрешение пакетов зависит от пользователя и может возвращать разные значения для разных пользователей в системе.

Каждый успешный вызов Add добавляет разрешенный пакет в граф пакетов вызывающего процесса, даже если он уже присутствует. API не применяет обнаружение дубликатов или фильтрацию (то есть несколько ссылок из пакета не являются вредными). После завершения разрешения зависимость пакета остается разрешенной для этого пользователя, пока последняя ссылка во всех процессах этого пользователя не будет удалена через PackageDependencyContext.Remove или процесс не будет завершен. Успешные вызовы этого метода изменяют значение PackageDependency.GenerationId .

После успешного возврата этого метода приложение сможет активировать типы и использовать содержимое из пакета платформы до вызова PackageDependencyContext.Remove .

Если в графе пакетов присутствует несколько пакетов с тем же рангом, что и вызов Add, разрешенный пакет (по умолчанию) добавляется после других с тем же рангом. Чтобы добавить пакет перед другими пользователями с тем же рангом, укажите PrependIfRankCollision в параметре options .

Дополнительные сведения см. в статье Использование API динамических зависимостей для ссылки на пакеты MSIX во время выполнения.

См. также раздел

• Использование API динамических зависимостей для ссылки на пакеты MSIX во время выполнения