LauncherOptions.ContentType Свойство

Определение

Пространство имен:

Windows.System

Возвращает или задает тип контента, связанный с универсальным кодом ресурса (URI), который представляет файл в сети.

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

Значение свойства

String

Platform::String

winrt::hstring

Тип содержимого универсального кода ресурса (URI).

Примеры

Вызовите метод Launcher.LaunchUriAsync(Uri, LauncherOptions), если ContentType имеет тип контента, связанный с запускаемого URI.

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

Комментарии

ContentType можно указать только при запуске URI с помощью Launcher.LaunchUriAsync(Uri, LauncherOptions).

Свойство ContentType позволяет приложению указать универсальный код ресурса (URI) вместе с типом контента. Его можно использовать для связывания универсального кода ресурса (URI), указывающего на ресурс в сети, с типом файла, а не с именем схемы URI. Windows попытается использовать тип файла, вычисленный из типа контента, чтобы выбрать приложение для запуска. Затем обработчику файлов по умолчанию передается универсальный код ресурса (URI) вместо пути к файлу. Например, если у вас есть URI http://, указывающий на файл .docx, щелчок по нему обычно открывает браузер и начинает скачивание файла. С помощью свойства ContentType можно пропустить промежуточный шаг и немедленно запустить обработчик файлов по умолчанию. Затем обработчик файлов может напрямую получить доступ к файлу в сети, используя путь, внедренный в URI.

Если обработчик не может работать непосредственно с URI, копия файла будет скачан от его имени.

Поскольку ContentType позволяет напрямую запускать обработчик файлов, те же проверки безопасности, которые применяются к запуску файла, применяются к запускам URI с указанным параметром. Дополнительные сведения об этих проверках безопасности см. в статье Запуск приложения по умолчанию для файла .

Примечание

Эта функция работает только в том случае, если обработчик файлов по умолчанию поддерживает отправку URI в файл в сети. Обработчик файлов по умолчанию также должен иметь возможность проверки подлинности на сервере файла. Из-за этих ограничений следует использовать свойство ContentType только в том случае, если вы тщательно протестировали комплексный сценарий между приложением и приложением, которое должно обрабатывать запускаемые файлы.

Важно!

Это свойство реализовано только на настольных устройствах.

См. также раздел

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• Пример запуска с сопоставлением
• Запуск приложения по умолчанию для файла
• Запуск приложения по умолчанию для URI
• Руководство по типам файлов и URI