LauncherOptions.ContentType Propriété

  • Référence

Définition

Espace de noms:
Windows.System
Modifier

Obtient ou définit le type de contenu associé à un URI qui représente un fichier sur le réseau.

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

Valeur de propriété

String

Platform::String

winrt::hstring

Type de contenu de l’URI.

Exemples

Appelez la méthode Launcher.LaunchUriAsync(Uri, LauncherOptions) avec ContentType défini sur le type de contenu associé à l’URI en cours de lancement.

// 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

Remarques

ContentType ne peut être spécifié que lors du lancement d’un URI à l’aide de Launcher.LaunchUriAsync(Uri, LauncherOptions).

La propriété ContentType permet à votre application de spécifier un URI ainsi qu’un type de contenu. Vous pouvez l’utiliser pour associer un URI pointant vers une ressource sur le réseau avec un type de fichier, au lieu d’un nom de schéma d’URI. Windows tente d’utiliser le type de fichier calculé à partir du type de contenu pour sélectionner l’application à lancer. Le gestionnaire de fichiers par défaut est ensuite passé l’URI au lieu d’un chemin d’accès de fichier. Par exemple, si vous avez un URI http:// pointant vers un fichier .docx, cliquer dessus ouvre normalement le navigateur et commence le téléchargement d’un fichier. En utilisant la propriété ContentType , vous pouvez ignorer l’étape intermédiaire et lancer immédiatement le gestionnaire de fichiers par défaut. Le gestionnaire de fichiers peut ensuite accéder directement au fichier sur le réseau à l’aide du chemin incorporé dans l’URI.

Si le gestionnaire ne peut pas travailler directement sur l’URI, une copie du fichier est téléchargée en leur nom.

Étant donné que ContentType vous permet de lancer directement un gestionnaire de fichiers, les mêmes vérifications de sécurité que celles qui s’appliquent au lancement de fichier s’appliquent aux lancements d’URI avec cette option spécifiée. Pour plus d’informations sur ces contrôles de sécurité, consultez Lancer l’application par défaut pour un fichier .

Notes

Cette fonctionnalité ne fonctionne que si le gestionnaire de fichiers par défaut prend en charge la transmission d’un URI à un fichier sur le réseau. Le gestionnaire de fichiers par défaut doit également être en mesure de s’authentifier auprès du serveur du fichier. En raison de ces limitations, vous ne devez utiliser la propriété ContentType que si vous avez testé minutieusement le scénario de bout en bout entre votre application et l’application que vous prévoyez de gérer les fichiers en cours de lancement

Important

Cette propriété est implémentée uniquement sur les appareils de bureau.

S’applique à

Voir aussi