PackageCatalog.RemoveOptionalPackagesAsync(IIterable<String>) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Remove os pacotes de aplicativos opcionais instalados da conta de usuário.
public:
virtual IAsyncOperation<PackageCatalogRemoveOptionalPackagesResult ^> ^ RemoveOptionalPackagesAsync(IIterable<Platform::String ^> ^ optionalPackageFamilyNames) = RemoveOptionalPackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PackageCatalogRemoveOptionalPackagesResult> RemoveOptionalPackagesAsync(IIterable<winrt::hstring> const& optionalPackageFamilyNames);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PackageCatalogRemoveOptionalPackagesResult> RemoveOptionalPackagesAsync(IEnumerable<string> optionalPackageFamilyNames);function removeOptionalPackagesAsync(optionalPackageFamilyNames)Public Function RemoveOptionalPackagesAsync (optionalPackageFamilyNames As IEnumerable(Of String)) As IAsyncOperation(Of PackageCatalogRemoveOptionalPackagesResult)Parâmetros
Uma lista de cadeias de caracteres de nome da família de pacotes opcionais.
Retornos
O resultado da remoção do pacote opcional na forma de: PackageCatalogRemoveOptionalPackagesResult.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v5.0)
|
Exemplos
Este exemplo demonstra a remoção de todos os pacotes opcionais de um pacote de main aplicativo.
public async void RemoveOptionalPackages()
{
// Create a list of the optional package family names
List<string> optionalPackageList = new List<string>();
foreach (var package in Windows.ApplicationModel.Package.Current.Dependencies)
{
if (package.IsOptional)
{
optionalPackageList.Add(package.Id.FamilyName);
}
}
// Remove the optional packages from the list
PackageCatalog catalog = Windows.ApplicationModel.PackageCatalog.OpenForCurrentPackage();
var removalResult = await catalog.RemoveOptionalPackagesAsync(optionalPackageList);
if (removalResult.ExtendedError != null)
{
throw removalResult.ExtendedError;
}
}
Comentários
Um nome de família de pacotes pode ser encontrado na propriedade FamilyName da PackageId.