Launcher.LaunchUriAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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)
Параметры
- options
- LauncherOptions
Параметры запуска приложения.
- inputData
- ValueSet
Входные данные для приложения.
Важно!
Объем передаваемых данных не должен превышать 100 КБ.
Возвращаемое значение
Возвращает значение true , если было запущено приложение по умолчанию для схемы URI; В противном случае значение false .
- Атрибуты
Комментарии
Если вы не вызываете этот API из классического приложения Windows, этот API должен вызываться из потока ASTA (также известного как поток пользовательского интерфейса).
Этот API также можно вызывать из классического приложения Windows.
Этот API запускает приложение по умолчанию для схемы, будь то приложение универсальная платформа Windows (UWP) или классическое приложение windows.
См. также раздел
Применяется к
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)
Параметры
- options
- LauncherOptions
Параметры запуска приложения.
Возвращаемое значение
Возвращает значение true , если было запущено приложение по умолчанию для схемы URI; В противном случае значение false .
- Атрибуты
Примеры
В этом примере используется [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 (также известного как поток пользовательского интерфейса).
Чтобы запустить URI интрасети, необходимо указать возможность privateNetworkClientServer в манифесте, например 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)
Параметры
Возвращаемое значение
Возвращает значение true , если было запущено приложение по умолчанию для схемы URI; В противном случае значение false .
- Атрибуты
Примеры
В этом примере для запуска 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.
Чтобы запустить URI интрасети, необходимо указать возможность privateNetworkClientServer в манифесте, например URI file:///, указывающий на сетевое расположение.
Этот метод нельзя использовать для запуска URI в локальной зоне. Например, приложения не могут использовать протокол file:/// для доступа к файлам на локальном компьютере. Вместо этого для доступа к файлам необходимо использовать API хранилища .
Если запуск завершается сбоем по любой из указанных выше причин, API завершится успешно и возвратит значение FALSE из своей асинхронной операции.
Чтобы разрешить пользователю выбирать приложение вместо запуска приложения по умолчанию, задайте свойство LauncherOptions.DisplayApplicationPicker .
Чтобы отобразить предупреждение о том, что URI потенциально небезопасн, задайте свойство LauncherOptions.TreatAsUntrusted .
URI передается в связанное приложение. Если связанное приложение является классическим приложением, универсальный код ресурса (URI) передается с помощью механизмов выполнения оболочки.
См. также раздел
- LaunchUriAsync(Uri, LauncherOptions)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Пример запуска с сопоставлением
- Руководство по типам файлов и URI
- Запуск приложения по умолчанию для URI
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по