Compartilhar via


LauncherOptions.ContentType Propriedade

Definição

Obtém ou define o tipo de conteúdo associado a um URI que representa um arquivo na rede.

public:
 property Platform::String ^ ContentType { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring ContentType();

void ContentType(winrt::hstring value);
public string ContentType { get; set; }
var string = launcherOptions.contentType;
launcherOptions.contentType = string;
Public Property ContentType As String

Valor da propriedade

String

Platform::String

winrt::hstring

O tipo de conteúdo do URI.

Exemplos

Chame o método Launcher.LaunchUriAsync(Uri, LauncherOptions) com ContentType definido como o tipo de conteúdo associado ao URI que está sendo iniciado.

// The URI to launch
string uriToLaunch = @"http://www.contoso.com/SomeFile.docx";
var uri = new Uri(uriToLaunch);

async void DefaultLaunch()
{
   // Set the URI's content type
   var options = new Windows.System.LauncherOptions();
   options.ContentType = "application/vnd.ms-word.document.12";

   // Launch the URI with the content type
   var success = await Windows.System.Launcher.LaunchUriAsync(uri, options);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}
// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.contoso.com/SomeFile.docx" };

Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
    // Set the URI's content type.
    Windows::System::LauncherOptions launcherOptions;
    launcherOptions.ContentType(L"application/vnd.ms-word.document.12");

    // Launch the URI.
    if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri, launcherOptions))
    {
        // URI launched.
    }
    else
    {
        // URI launch failed.
    }
}
// The URI to launch.
auto uri = ref new Windows::Foundation::Uri("http://www.contoso.com/SomeFile.docx");

void MainPage::DefaultLaunch()
{
   // Set the URI's content type
   auto launchOptions = ref new Windows::System::LauncherOptions();
   launchOptions->ContentType = "application/vnd.ms-word.document.12";

   // Launch the URI with the content type
   concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri, launchOptions));
   launchUriOperation.then([](bool success)
   {
      if (success)
      {
         // URI launched
      }
      else
      {
         // URI launch failed
      }
   });
}
' The URI to launch
Dim uri As New Uri("http://www.contoso.com/SomeFile.docx")

async Sub DefaultLaunch()

   ' Set the URI's content type
   Dim options = Windows.System.LauncherOptions()
   options.ContentType = "application/vnd.ms-word.document.12"

   ' Launch the URI with the content type
   Dim success = await Windows.System.Launcher.LaunchUriAsync(uri, options)

   If success Then
      ' URI launched
   Else
      ' URI launch failed
   End If

End Sub

Comentários

ContentType só pode ser especificado ao iniciar um URI usando Launcher.LaunchUriAsync(Uri, LauncherOptions).

A propriedade ContentType permite que seu aplicativo especifique um URI junto com um tipo de conteúdo. Você pode usar isso para associar um URI apontando para um recurso na rede com um tipo de arquivo, em vez de um nome de esquema de URI. O Windows tentará usar o tipo de arquivo calculado do tipo de conteúdo para selecionar o aplicativo a ser iniciado. O manipulador de arquivos padrão é então passado o URI em vez de um caminho de arquivo. Portanto, por exemplo, se você tiver um URI http:// apontando para um arquivo .docx, clicar nele normalmente abriria o navegador e iniciaria um download de arquivo. Usando a propriedade ContentType , você pode ignorar a etapa intermediária e fazer com que o manipulador de arquivos padrão seja iniciado imediatamente. Em seguida, o manipulador de arquivos pode acessar diretamente o arquivo na rede usando o caminho inserido no URI.

Se o manipulador não puder trabalhar diretamente no URI, uma cópia do arquivo será baixada em seu nome.

Como ContentType permite iniciar diretamente um manipulador de arquivos, as mesmas verificações de segurança que se aplicam à inicialização de arquivo se aplicam a inicializações de URI com essa opção especificada. Consulte Iniciar o aplicativo padrão para obter um arquivo para obter mais detalhes sobre essas verificações de segurança.

Observação

Essa funcionalidade só funcionará se o manipulador de arquivos padrão der suporte a ser passado um URI para um arquivo na rede. O manipulador de arquivos padrão também deve ser capaz de autenticar com o servidor do arquivo. Devido a essas limitações, você só deve usar a propriedade ContentType se tiver testado completamente o cenário de ponta a ponta entre seu aplicativo e o do aplicativo que você espera lidar com os arquivos que estão sendo iniciados

Importante

Essa propriedade só é implementada em dispositivos desktop.

Aplica-se a

Confira também