Navigieren zwischen Den Aufgabenbereichen des Diensts
Zum Navigieren zwischen Dienstaufgabenbereich in Windows Media Player verwenden Sie die NavigateTaskPaneURL-Methode, die mithilfe des window.external-Objekts verfügbar ist. Wenn Sie diese Methode verwenden, geben Sie Werte für drei Parameter an:
- bstrKeyName. Dies ist der Schlüsselname des Onlineshops. Verwenden Sie beim Navigieren in einem Onlineshop den Schlüsselnamen des aktuellen Speichers.
- bstrTaskPane. Diese Zeichenfolge enthält den Namen des Dienstaufgabebereichs, zu dem Sie navigieren möchten.
- bstrParams. Diese Zeichenfolge enthält die Abfragezeichenfolgenparameter, die Sie an die URL für die Webseite anfügen möchten, die von dem Dienstaufgabebereich gehostet wird, zu dem Sie navigieren möchten.
Die Navigation wird von einer Webseite verwaltet, die Sie erstellen, die als Navigationsseite bezeichnet wird. Die URL für die Navigationsseite wird durch das Navigate-Element im ServiceInfo-Dokument angegeben. Wenn Sie NavigateTaskPaneURL aufrufen, Windows Media Player die Navigationsseite geöffnet, nicht die Webseite, die durch die ServiceTask1-, ServiceTask2- oder ServiceTask3-Elemente angegeben wird. Es ist die Navigationsseite, die die von bstrParams angegebene Abfragezeichenfolge empfängt. Die Navigationsseite sollte die Regeln enthalten, die bestimmen, welche Inhalte nach der Navigation in einem Dienstaufgabebereich angezeigt werden.
Angenommen, Sie möchten, dass Benutzer auf einen Link klicken, um von ServiceTask1 zu ServiceTask2 zu navigieren. Sie können den folgenden HTML-Code verwenden, um den Link zu erstellen:
<A HREF = "javascript:window.external.NavigateTaskPaneURL('MSSampleMusic', 'ServiceTask2', 'From=Music&To=2')">Video</A>
Wenn der Benutzer auf den Link Video klickt, wechselt Windows Media Player zu ServiceTask2 und öffnet die Navigationsseite und fügt die folgende Abfragezeichenfolge an die URL an.
?From=Music&To=2
Der From-Parameter identifiziert die Seite, von der aus der Benutzer auf den Link geklickt hat, und der To-Parameter identifiziert die Nummer des Dienstaufgabebereichs, zu dem er navigieren möchte. (Beachten Sie, dass diese Parameter nichts Besonderes sind. Sie können beliebige Parameter für beliebige Zwecke verwenden.)
Der folgende Beispielcode zeigt beispielsweise das Navigate-Element in einem ServiceInfo-Dokument:
<Navigate
BaseURL = "https://www.proseware.com/service/html/navigate.asp">
Die resultierende URL, die mit der Abfragezeichenfolge abgeschlossen ist, wird im folgenden Beispiel gezeigt:
https://www.proseware.com/service/html/navigate.asp?From=Music&To=2
Der folgende Beispielcode zeigt die Navigationsseite:
<%
Dim sURL
Dim sQS
Dim sTo
sURL = ""
sQS = Request.ServerVariables("QUERY_STRING")
sTo = "" & Request.QueryString("To")
Select Case sTo
Case "1" sURL = sURL & "Music_Music.asp"
Case "2" sURL = sURL & "Music_Video.asp"
Case "3" sURL = sURL & "Music_Radio.asp"
Case Else sURL = sURL & "Music_Music.asp"
End Select
sURL = sURL & "?" & sQS
Response.Redirect(sURL)
%>
Der vorangehende Code erstellt einfach eine URL und leitet den Browser an diese um. Zunächst ruft der Code To-Werte aus der URL-Abfragezeichenfolge und der Abfragezeichenfolge selbst ab. Sie verwendet den Wert des To-Parameters, um zu bestimmen, welche Seite angezeigt werden soll. Anschließend wird die ursprüngliche Abfragezeichenfolge an die URL angefügt. Schließlich navigiert er im Browser mit einer URL, die der folgenden ähnelt:
https://www.proseware.com/service/html/Video.asp?locale=409&geoid=f4&version=10.0.0.3600&userlocale=409&From=Music&To=2
Wenn Sie die Navigation auf diese Weise ausführen, müssen Sie External.SelectedTaskPane angeben, um sicherzustellen, dass die richtige Taskschaltfläche hervorgehoben ist.
- Warnung Seien Sie vorsichtig, wie Sie Abfragezeichenfolgenparameter für die Navigation verwenden.
HTMLView-Webseiten können von allen Personen bereitgestellt werden, die eine ASX-Wiedergabeliste erstellen. Dies bedeutet, dass schädliche Websites Abfragezeichenfolgenwerte mit NavigateTaskPaneURL an Ihren Onlineshop übergeben können. Sie müssen diese Möglichkeit einplanen, um Ihren Onlineshop sicher zu halten. Wenn Ihr Onlineshop dem Benutzer z. B. einfach einen Abfragezeichenfolgenwert anzeigt, kann eine schädliche Website unerwarteten Text anzeigen.