LauncherOptions.ContentType Eigenschaft

Referenz

Definition

Namespace:: Windows.System

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft den Inhaltstyp ab, der einem URI zugeordnet ist, der eine Datei im Netzwerk darstellt, oder legt diesen fest.

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

Eigenschaftswert

String

Platform::String

winrt::hstring

Der Inhaltstyp des URI.

Beispiele

Rufen Sie die Launcher.LaunchUriAsync(Uri, LauncherOptions) -Methode auf, wobei ContentType auf den Inhaltstyp festgelegt ist, der dem gestarteten URI zugeordnet ist.

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

Hinweise

ContentType kann nur beim Starten eines URI mit Launcher.LaunchUriAsync(Uri, LauncherOptions) angegeben werden.

Mit der ContentType-Eigenschaft kann Ihre App einen URI zusammen mit einem Inhaltstyp angeben. Sie können dies verwenden, um einen URI, der auf eine Ressource im Netzwerk verweist, einem Dateityp anstelle eines URI-Schemanamens zuzuordnen. Windows versucht, den aus dem Inhaltstyp berechneten Dateityp zu verwenden, um die app auszuwählen, die gestartet werden soll. Der Standarddateihandler wird dann anstelle eines Dateipfads den URI übergeben. Wenn Sie also beispielsweise über einen http:// URI verfügen, der auf eine .docx-Datei verweist, würde ein Klicken darauf normalerweise den Browser öffnen und einen Dateidownload starten. Mithilfe der ContentType-Eigenschaft können Sie den Zwischenschritt überspringen und den Standarddateihandler sofort starten lassen. Der Dateihandler kann dann über den in den URI eingebetteten Pfad direkt auf die Datei im Netzwerk zugreifen.

Wenn der Handler nicht direkt mit dem URI arbeiten kann, wird eine Kopie der Datei in ihrem Namen heruntergeladen.

Da ContentType es Ihnen ermöglicht, einen Dateihandler direkt zu starten, gelten dieselben Sicherheitsüberprüfungen, die für den Dateistart gelten, auch für URI-Starts mit dieser Option. Weitere Informationen zu diesen Sicherheitsüberprüfungen finden Sie unter Starten der Standard-App für eine Datei .

Hinweis

Diese Funktionalität funktioniert nur, wenn der Standarddateihandler die Übergabe eines URI an eine Datei im Netzwerk unterstützt. Der Standarddateihandler muss auch in der Lage sein, sich beim Dateiserver zu authentifizieren. Aufgrund dieser Einschränkungen sollten Sie die ContentType-Eigenschaft nur verwenden, wenn Sie das End-to-End-Szenario zwischen Ihrer App und den Apps gründlich getestet haben, von denen Sie erwarten, dass sie die gestarteten Dateien behandeln.

Wichtig

Diese Eigenschaft wird nur auf Desktopgeräten implementiert.

Gilt für: