LauncherOptions.ContentType Propiedad

Definición

Obtiene o establece el tipo de contenido asociado a un URI que representa un archivo en la red.

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

Valor de propiedad

String

Platform::String

winrt::hstring

Tipo de contenido del URI.

Ejemplos

Llame al método Launcher.LaunchUriAsync(Uri, LauncherOptions) con ContentType establecido en el tipo de contenido asociado al URI que se está iniciando.

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

Comentarios

ContentType solo se puede especificar al iniciar un URI mediante Launcher.LaunchUriAsync(Uri, LauncherOptions).

La propiedad ContentType permite a la aplicación especificar un URI junto con un tipo de contenido. Puede usarlo para asociar un URI que apunte a un recurso de la red con un tipo de archivo, en lugar de un nombre de esquema URI. Windows intentará usar el tipo de archivo calculado desde el tipo de contenido para seleccionar la aplicación que se va a iniciar. A continuación, el controlador de archivos predeterminado se pasa el URI en lugar de una ruta de acceso de archivo. Por ejemplo, si tiene un URI de http:// que apunta a un archivo .docx, al hacer clic en él normalmente abriría el explorador y comenzaría una descarga de archivos. Con la propiedad ContentType , puede omitir el paso intermedio y hacer que el controlador de archivos predeterminado se inicie inmediatamente. Después, el controlador de archivos puede acceder directamente al archivo en la red mediante la ruta de acceso incrustada en el URI.

Si el controlador no puede trabajar directamente en el URI, se descargará una copia del archivo en su nombre.

Dado que ContentType permite iniciar directamente un controlador de archivos las mismas comprobaciones de seguridad que se aplican al inicio de archivos se aplican a los inicios de URI con esta opción especificada. Consulte Iniciar la aplicación predeterminada para obtener más información sobre esas comprobaciones de seguridad.

Nota:

Esta funcionalidad solo funciona si el controlador de archivos predeterminado admite pasar un URI a un archivo de la red. El controlador de archivos predeterminado también debe poder autenticarse con el servidor del archivo. Debido a estas limitaciones, solo debes usar la propiedad ContentType si has probado exhaustivamente el escenario de un extremo a otro entre la aplicación y los que esperas controlar los archivos que se inician.

Importante

Esta propiedad solo se implementa en dispositivos de escritorio.

Se aplica a

Consulte también