LauncherOptions.PreferredApplicationPackageFamilyName Propriedade

Definição

Namespace:

Windows.System

Obtém ou define um valor que representa o nome da família de pacotes do aplicativo na Loja que o usuário deve instalar se não houver nenhum aplicativo para manipular o tipo de arquivo ou o URI.

public:
 property Platform::String ^ PreferredApplicationPackageFamilyName { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring PreferredApplicationPackageFamilyName();

void PreferredApplicationPackageFamilyName(winrt::hstring value);

public string PreferredApplicationPackageFamilyName { get; set; }

var string = launcherOptions.preferredApplicationPackageFamilyName;
launcherOptions.preferredApplicationPackageFamilyName = string;

Public Property PreferredApplicationPackageFamilyName As String

Valor da propriedade

String

Platform::String

winrt::hstring

O nome da família de pacotes do aplicativo.

Exemplos

Consulte o exemplo de código no tópico LauncherOptions.PreferredApplicationDisplayName .

Comentários

Em alguns casos, pode ser que o usuário não tenha um aplicativo instalado para manipular o arquivo que você está iniciando. Por padrão, nesses casos, o Windows oferece ao usuário um link para pesquisar o aplicativo apropriado na Loja. Use LauncherOptions.PreferredApplicationDisplayName em conjunto com LauncherOptions.preferredApplicationPackageFamilyName para fornecer ao usuário um aplicativo na Microsoft Store que ele possa adquirir para manipular o arquivo. O nome de exibição que você usa deve corresponder ao nome de exibição do aplicativo na Microsoft Store.

Você deve definir ambas as propriedades de aplicativo preferenciais para recomendar um aplicativo. Se você definir uma opção sem a outra, haverá falha.

Observação

Não é possível definir as propriedades preferenciais do aplicativo e o URI de fallback ao mesmo tempo, pois apenas um fallback pode ser usado. A API do Inicializador falhará se ambos os fallbacks forem definidos.

Importante

Essa propriedade só é implementada em dispositivos desktop.

Confira também

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• Amostra de inicialização de associação
• Iniciar o app padrão para um arquivo
• Iniciar o app padrão para um URI
• Diretrizes para tipos de arquivos e URIs