PackageCatalog.AddOptionalPackageAsync(String) 메서드

정의

네임스페이스:

Windows.ApplicationModel

패키지 카탈로그에 선택적 패키지를 추가합니다.

public:
 virtual IAsyncOperation<PackageCatalogAddOptionalPackageResult ^> ^ AddOptionalPackageAsync(Platform::String ^ optionalPackageFamilyName) = AddOptionalPackageAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PackageCatalogAddOptionalPackageResult> AddOptionalPackageAsync(winrt::hstring const& optionalPackageFamilyName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PackageCatalogAddOptionalPackageResult> AddOptionalPackageAsync(string optionalPackageFamilyName);

function addOptionalPackageAsync(optionalPackageFamilyName)

Public Function AddOptionalPackageAsync (optionalPackageFamilyName As String) As IAsyncOperation(Of PackageCatalogAddOptionalPackageResult)

매개 변수

optionalPackageFamilyName

String

Platform::String

winrt::hstring

카탈로그에 추가할 선택적 패키지의 패키지 패밀리입니다.

반환

IAsyncOperation<PackageCatalogAddOptionalPackageResult>

패키지를 추가하기 위한 비동기 작업을 시작한 결과입니다.

특성

RemoteAsyncAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

예제

아래 예제에서는 앱 패키지 패밀리 이름을 기반으로 선택적 앱 패키지를 설치합니다.

var packageCatalog = PackageCatalog.OpenForCurrentPackage();
string familyName = "<Your app package family name>";
Package installedPackage = await packageCatalog.AddOptionalPackageAsync(familyName);

설명

이 메서드는 관련 집합의 선택적 패키지에 대해서만 작동합니다.