Launcher.LaunchUriAsync Метод

Ссылка

Определение

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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

LaunchUriAsync(Uri, LauncherOptions, ValueSet)	Запускает приложение по умолчанию, связанное с именем схемы URI для указанного URI, используя указанные параметры и входные данные.
LaunchUriAsync(Uri, LauncherOptions)	Запускает приложение по умолчанию, связанное с именем схемы URI или с именем, указанным в ContentType для указанного URI, используя указанные параметры.
LaunchUriAsync(Uri)	Запускает приложение по умолчанию, связанное с именем схемы URI для указанного URI.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Изменить

Запускает приложение по умолчанию, связанное с именем схемы URI для указанного URI, используя указанные параметры и входные данные.

public:
 static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options, ValueSet ^ inputData);

/// [Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
 static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options, ValueSet const& inputData);

[Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options, ValueSet inputData);

function launchUriAsync(uri, options, inputData)

Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions, inputData As ValueSet) As IAsyncOperation(Of Boolean)

Параметры

uri: Uri Uri

Универсальный код ресурса (URI).

options: LauncherOptions

Параметры запуска приложения.

inputData: ValueSet

Входные данные для приложения.

Важно!

Объем передаваемых данных не должен превышать 100 КБ.

Возвращаемое значение

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Возвращает значение true , если было запущено приложение по умолчанию для схемы URI; В противном случае значение false .

Атрибуты: OverloadAttribute

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

Применяется к

LaunchUriAsync(Uri, LauncherOptions)

Изменить

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

public:
 static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options);

/// [Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
 static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options);

[Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options);

function launchUriAsync(uri, options)

Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions) As IAsyncOperation(Of Boolean)

Параметры

uri: Uri Uri

Универсальный код ресурса (URI).

options: LauncherOptions

Параметры запуска приложения.

Возвращаемое значение

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Атрибуты: OverloadAttribute

Примеры

В этом примере используется [LaunchUriAsync(Uri, LauncherOptions) для запуска URI с предупреждением. Свойство TreatAsUntrusted указывает, что в системе должно отображаться предупреждение.

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

async void DefaultLaunch()
{
   // Set the option to show a warning
   var options = new Windows.System.LauncherOptions();
   options.TreatAsUntrusted = true;

   // Launch the URI with a warning prompt
   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.bing.com" };

Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
    // Set the option to show a warning
    Windows::System::LauncherOptions launcherOptions;
    launcherOptions.TreatAsUntrusted(true);

    // 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.bing.com");

void MainPage::DefaultLaunch()
{
   // Set the option to show a warning
   auto launchOptions = ref new Windows::System::LauncherOptions();
   launchOptions->TreatAsUntrusted = true;

   // Launch the URI with a warning prompt
   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.bing.com")

async Sub DefaultLaunch()

   ' Set the option to show a warning
   Dim options = Windows.System.LauncherOptions()
   options.TreatAsUntrusted = True

   ' Launch the URI with a warning prompt
   Dim success = await Windows.System.Launcher.LaunchUriAsync(uri, options)

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

End Sub

Этот метод нельзя использовать для запуска URI в локальной зоне. Например, приложения не могут использовать протокол file:/// для доступа к файлам на локальном компьютере. Вместо этого для доступа к файлам необходимо использовать API хранилища .

Тип контента используется для вычисления расширения файла. Из расширения выбирается приложение по умолчанию. Например, значение типа контента ""application/vnd.ms-word.document.12" сопоставляется с ".docx", а затем запускается приложение по умолчанию для ".docx". Пример:

// this specifies the file type, which is used to bind to Word. 
launcherOptions.ContentType = "application/vnd.ms-word.document.12"; 
// and then this launches the file using the application
Launcher.LaunchUriAsync("http://www.cloud.com/file.docx", options);

Если запуск завершается сбоем по любой из указанных выше причин, API завершится успешно и возвратит значение FALSE из своей асинхронной операции.

Чтобы разрешить пользователю выбирать приложение вместо запуска приложения по умолчанию, задайте свойство LauncherOptions.DisplayApplicationPicker .

Чтобы отобразить предупреждение о том, что URI потенциально небезопасн, задайте свойство LauncherOptions.TreatAsUntrusted .

URI передается в связанное приложение. Если связанное приложение является классическим приложением, универсальный код ресурса (URI) передается с помощью механизмов выполнения оболочки.

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

Применяется к

LaunchUriAsync(Uri)

Изменить

Запускает приложение по умолчанию, связанное с именем схемы URI для указанного URI.

public:
 static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri);

/// [Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
 static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri);

[Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri);

function launchUriAsync(uri)

Public Shared Function LaunchUriAsync (uri As Uri) As IAsyncOperation(Of Boolean)

Параметры

uri: Uri Uri

Универсальный код ресурса (URI).

Возвращаемое значение

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Атрибуты: OverloadAttribute

Примеры

В этом примере для запуска URI используется LaunchUriAsync(Uri).

// The URI to launch
string uriToLaunch = @"http://www.bing.com";

// Create a Uri object from a URI string 
var uri = new Uri(uriToLaunch);

// Launch the URI
async void DefaultLaunch()
{
   // Launch the URI
   var success = await Windows.System.Launcher.LaunchUriAsync(uri);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };
...
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
    // Launch the URI.
    if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri))
    {
        // URI launched.
    }
    else
    {
        // URI launch failed.
    }
}

// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");

void MainPage::DefaultLaunch()
{
   // Launch the URI
   concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri));
   launchUriOperation.then([](bool success)
   {
      if (success)
      {
         // URI launched
      }
      else
      {
         // URI launch failed
      }
   });
}

' The URI to launch
Dim uri As New Uri("http://www.bing.com")

async Sub DefaultLaunch()

   ' Launch the URI
   Dim success = await Windows.System.Launcher.LaunchUriAsync(uri)

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

End Sub

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

Применяется к

Launcher.LaunchUriAsync Метод

Определение

Перегрузки

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Параметры

Возвращаемое значение

Комментарии

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

Применяется к

LaunchUriAsync(Uri, LauncherOptions)

Параметры

Возвращаемое значение

Примеры

Комментарии

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

Применяется к

LaunchUriAsync(Uri)

Параметры

Возвращаемое значение

Примеры

Комментарии

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

Применяется к

Обратная связь

Обратная связь

Дополнительные ресурсы