Condividi tramite


LauncherOptions.ContentType Proprietà

Definizione

Ottiene o imposta il tipo di contenuto associato a un URI che rappresenta un file nella rete.

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

Valore della proprietà

String

Platform::String

winrt::hstring

Tipo di contenuto dell'URI.

Esempio

Chiamare il metodo Launcher.LaunchUriAsync(Uri, LauncherOptions) con ContentType impostato sul tipo di contenuto associato all'URI avviato.

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

Commenti

ContentType può essere specificato solo quando si avvia un URI usando Launcher.LaunchUriAsync(Uri, LauncherOptions).

La proprietà ContentType consente all'app di specificare un URI insieme a un tipo di contenuto. È possibile usarlo per associare un URI che punta a una risorsa nella rete con un tipo di file anziché un nome dello schema URI. Windows tenterà di usare il tipo di file calcolato dal tipo di contenuto per selezionare l'app da avviare. Il gestore file predefinito viene quindi passato l'URI anziché un percorso di file. Ad esempio, se si dispone di un URI di http:// che punta a un file .docx, facendo clic su di esso normalmente aprire il browser e avviare un download di file. Usando la proprietà ContentType è possibile ignorare il passaggio intermedio e avviare immediatamente il gestore file predefinito. Il gestore file può quindi accedere direttamente al file nella rete usando il percorso incorporato nell'URI.

Se il gestore non è in grado di funzionare direttamente nell'URI, verrà scaricata una copia del file per conto del gestore.

Poiché ContentType consente di avviare direttamente un gestore file, gli stessi controlli di sicurezza che si applicano all'avvio del file si applicano ai lanci URI con questa opzione specificata. Per altre informazioni su tali controlli di sicurezza, vedere Avviare l'app predefinita per un file .

Nota

Questa funzionalità funziona solo se il gestore file predefinito supporta il passaggio di un URI a un file nella rete. Il gestore file predefinito deve anche essere in grado di eseguire l'autenticazione con il server del file. A causa di queste limitazioni è consigliabile usare solo la proprietà ContentType se si è testato accuratamente lo scenario end-to-end tra l'app e l'app che si prevede di gestire i file avviati

Importante

Questa proprietà viene implementata solo nei dispositivi Desktop.

Si applica a

Vedi anche