PackageDependency.Add 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| Add() |
Create 메서드를 사용하여 이전에 만든 프레임워크 패키지 종속성에 대한 런타임 참조를 추가합니다. 이 메서드가 성공적으로 반환되면 앱이 형식을 활성화하고 프레임워크 패키지의 콘텐츠를 사용할 수 있습니다. |
| Add(AddPackageDependencyOptions) |
지정한 옵션과 함께 Create 메서드를 사용하여 이전에 만든 프레임워크 패키지 종속성에 대한 런타임 참조를 추가합니다. 이 메서드가 성공적으로 반환되면 앱이 형식을 활성화하고 프레임워크 패키지의 콘텐츠를 사용할 수 있습니다. |
Add()
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반환
프레임워크 패키지 종속성에 대한 컨텍스트 정보를 제공하고 런타임 참조를 제거할 수 있는 개체입니다.
- 특성
설명
이 메서드를 호출하면 프레임워크 패키지 종속성이 시스템의 특정 패키지로 확인됩니다. 또한 프레임워크 패키지가 현재 사용 중임을 OS에 알리고 모든 버전 업데이트를 병렬로 처리합니다(앱이 사용이 완료될 때까지 이전 버전 제거 또는 서비스 효과적으로 지연). 패키지 확인은 사용자와 관련이 있으며 시스템의 다른 사용자에 대해 서로 다른 값을 반환할 수 있습니다.
성공한 각 추가 호출은 이미 있는 경우에도 확인된 패키지를 호출 프로세스의 패키지 그래프에 추가합니다. API에 의해 적용된 중복 검색 또는 필터링이 없습니다(즉, 패키지의 여러 참조가 유해하지 않음). 해결이 완료되면 PackageDependencyContext.Remove 를 통해 해당 사용자의 모든 프로세스에서 마지막 참조가 제거되거나 프로세스가 종료될 때까지 패키지 종속성이 해당 사용자에 대해 확인됩니다. 이 메서드를 성공적으로 호출하면 PackageDependency.GenerationId 값이 변경됩니다.
이 메서드가 성공적으로 반환되면 앱은 PackageDependencyContext.Remove 가 호출될 때까지 형식을 활성화하고 프레임워크 패키지의 콘텐츠를 사용할 수 있습니다.
추가 호출과 동일한 순위를 가진 패키지 그래프에 여러 패키지가 있는 경우 확인된 패키지는 동일한 순위의 다른 패키지 다음에 추가됩니다.
자세한 내용은 동적 종속성 API를 사용하여 런타임에 MSIX 패키지를 참조하세요.
추가 정보
적용 대상
Add(AddPackageDependencyOptions)
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
프레임워크 패키지 참조를 지정하는 추가 옵션을 정의합니다.
반환
프레임워크 패키지 종속성에 대한 컨텍스트 정보를 제공하고 런타임 참조를 제거할 수 있는 개체입니다.
- 특성
설명
이 메서드를 호출하면 프레임워크 패키지 종속성이 시스템의 특정 패키지로 확인됩니다. 또한 프레임워크 패키지가 현재 사용 중임을 OS에 알리고 모든 버전 업데이트를 병렬로 처리합니다(앱이 사용이 완료될 때까지 이전 버전 제거 또는 서비스 효과적으로 지연). 패키지 확인은 사용자와 관련이 있으며 시스템의 다른 사용자에 대해 서로 다른 값을 반환할 수 있습니다.
성공한 각 추가 호출은 이미 있는 경우에도 확인된 패키지를 호출 프로세스의 패키지 그래프에 추가합니다. API에 의해 적용된 중복 검색 또는 필터링이 없습니다(즉, 패키지의 여러 참조가 유해하지 않음). 해결이 완료되면 PackageDependencyContext.Remove 를 통해 해당 사용자의 모든 프로세스에서 마지막 참조가 제거되거나 프로세스가 종료될 때까지 패키지 종속성이 해당 사용자에 대해 확인됩니다. 이 메서드를 성공적으로 호출하면 PackageDependency.GenerationId 값이 변경됩니다.
이 메서드가 성공적으로 반환되면 앱은 PackageDependencyContext.Remove 가 호출될 때까지 형식을 활성화하고 프레임워크 패키지의 콘텐츠를 사용할 수 있습니다.
추가 호출과 동일한 순위를 가진 패키지 그래프에 여러 패키지가 있는 경우 확인된 패키지는 기본적으로 동일한 순위의 다른 패키지 다음에 추가됩니다. 동일한 순위의 다른 항목 앞에 패키지를 추가하려면 options 매개 변수에 PrependIfRankCollision을 지정합니다.
자세한 내용은 동적 종속성 API를 사용하여 런타임에 MSIX 패키지를 참조하세요.