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

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

Важный

Свойство TargetApplicationPackageFamilyName параметра параметра, а иногда необязательно, требуется для этой перегрузки метода LaunchUriAsync.

inputData

ValueSet

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

Важный

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

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

Атрибуты

OverloadAttribute

Комментарии

Если вы не вызываете этот API из классического приложения Windows, этот API должен вызываться из потока ASTA (также известного как поток пользовательского интерфейса).

Этот API также может вызываться из классического приложения Windows.

Этот API запускает приложение по умолчанию для схемы, будь то приложение универсальной платформы Windows (UWP) или классическое приложение Windows.

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

• LaunchUriAsync(Uri)
• LaunchUriAsync(Uri, LauncherOptions)

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>

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

Атрибуты

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

Комментарии

Если вы не вызываете этот API из классического приложения Windows, этот API должен вызываться из потока ASTA (также известного как поток пользовательского интерфейса).

Этот API также может вызываться из классического приложения Windows.

Этот API запускает приложение по умолчанию для схемы, будь то приложение универсальной платформы Windows (UWP) или классическое приложение Windows.

Вызывающее приложение должно быть видно пользователю при вызове этого API.

Если вы не вызываете этот API из классического приложения Windows, этот API должен вызываться из потока ASTA (также известного как поток пользовательского интерфейса).

Необходимо указать возможность privateNetworkClientServer в манифесте, чтобы запустить URI интрасети, например URI file:///, указывающий на сетевое расположение.

Этот метод нельзя использовать для запуска 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)
• LaunchUriAsync(Uri, LauncherOptions, ValueSet)
• пример запуска ассоциации
• Рекомендации по типам файлов и 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>

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

Атрибуты

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

Комментарии

Если вы не вызываете этот API из классического приложения Windows, этот API должен вызываться из потока ASTA (также известного как поток пользовательского интерфейса).

Этот API также может вызываться из классического приложения Windows.

Этот API запускает приложение по умолчанию для схемы, будь то приложение универсальной платформы Windows (UWP) или классическое приложение Windows.

Вызывающее приложение должно быть видно пользователю при вызове API.

Необходимо указать возможность privateNetworkClientServer в манифесте, чтобы запустить URI интрасети, например URI file:///, указывающий на сетевое расположение.

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

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

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

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

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

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

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