HyperlinkButton.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 navigiert werden soll, wenn auf das HyperlinkButton-Element geklickt wird, 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 = hyperlinkButton.navigateUri;
hyperlinkButton.navigateUri = uri;
Public Property NavigateUri As Uri
<HyperlinkButton NavigateUri="uriString"/>
Eigenschaftswert
Der URI (Uniform Resource Identifier), zu dem navigiert werden soll, wenn auf das HyperlinkButton-Element geklickt wird.
Beispiele
Hier ist ein LinkButton wie in XAML deklariert. Es deklariert einen Zeichenfolgenwert für Content und einen NavigateUri-Wert.
<HyperlinkButton Content="www.microsoft.com" NavigateUri="https://www.microsoft.com"/>
Hinweise
Wenn ein Benutzer auf einen HyperlinkButton klickt oder anderweitig aufruft, wird der URI geöffnet, den Sie für die NavigateUri-Eigenschaft im Standardbrowser angegeben haben.
Sie müssen keine http:- oder https:- Schemas für den URI 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.
HyperlinkButton ist ein Steuerelement, daher verfügt es über Eingabeereignisse wie Tapped, und es handelt sich um eine ButtonBase-Unterklasse , sodass es auch über ein Click-Ereignis verfügt. In der Regel geben Sie keinen Wert für NavigateUri an und behandeln auch Eingabeereignisse, die als Klicken auf das HyperlinkButton-Element interpretiert werden. Die Aktion zum Öffnen von NavigateUri in einem Standardbrowser ist eine Systemaktion, die ohne Ereignisbehandlung erfolgt. Wenn Sie beabsichtigen, dass HyperlinkButton 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 legen Sie die WebView2.Source-Eigenschaft auf den zu ladenden URI fest.