Hyperlink.NavigateUri Eigenschaft
Definition
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.
Ruft den URI (Uniform Resource Identifier) ab, zu dem beim Aktivieren des Links navigiert werden soll, oder legt diesen fest.
public:
property Uri ^ NavigateUri { Uri ^ get(); void set(Uri ^ value); };Uri NavigateUri();
void NavigateUri(Uri value);public System.Uri NavigateUri { get; set; }var uri = hyperlink.navigateUri;
hyperlink.navigateUri = uri;Public Property NavigateUri As Uri<Hyperlink NavigateUri="uriString"/>
Eigenschaftswert
Der URI (Uniform Resource Identifier), zu dem beim Aktivieren des Links navigiert werden soll. Der Standardwert ist NULL.
Hinweise
Standardmäßig wird ein Link als Textlink angezeigt. Wenn ein Benutzer darauf klickt, wird der URI geöffnet, den Sie in der NavigateUri-Eigenschaft im Standardbrowser angeben. (Genauer gesagt, es wird in der App gestartet, die für das bestimmte Schema/Protokoll registriert ist, wie Sie im NavigateUri-Wert angegeben haben.) Der Standardbrowser ist ein separater Prozess von Ihrer App. Die typische Benutzererfahrung besteht darin, dass eine neue Browser-App neben Ihrer App als geteilter Bereich angezeigt wird und der Browser den Fokus erhält.
Sie müssen das Click-Ereignis nicht behandeln, um die Navigation zu verursachen, wenn Sie einen Wert für NavigateUri angeben. Das Click-Ereignis ist für die Navigation innerhalb der App vorgesehen, z. B. wenn eine neue App-Seite geladen werden soll, und für dieses Szenario benötigen Sie keinen NavigateUri-Wert. Es gibt auch nichts, was Sie innerhalb des Click-Ereignishandlers tun können, um zu verhindern, dass der Standardbrowser ein gültiges Ziel lädt, das für NavigateUri angegeben ist. Diese Aktion wird automatisch (asynchron) ausgeführt, wenn der Link aktiviert wird, und kann nicht innerhalb des Click-Ereignishandlers abgebrochen werden.
Wenn Sie beabsichtigen, dass der Hyperlink einen angegebenen URI innerhalb eines WebView2-Steuerelements laden soll, das ebenfalls Teil Ihrer App ist, geben Sie keinen Wert für NavigateUri an. Behandeln Sie stattdessen das Click-Ereignis , und rufen Sie WebView2.Source auf, und geben Sie den zu ladenden URI an.
Du musst nicht das Schema http: oder https: verwenden. Stattdessen kannst du Schemas wie ms-appx:, ms-appdata: oder ms-resources: verwenden, falls dort Ressourceninhalte vorhanden sind, die in einem Browser geladen werden können. Das Schema file: ist allerdings ausdrücklich blockiert. Weitere Informationen finden Sie unter URI-Schemas.