SearchPane.SearchHistoryContext Eigenschaft

Definition

Namespace:

Windows.ApplicationModel.Search

Eine Zeichenfolge, die den Kontext der Suche identifiziert und zum Speichern des Suchverlaufs des Benutzers in der App verwendet wird.

public:
 property Platform::String ^ SearchHistoryContext { Platform::String ^ get(); void set(Platform::String ^ value); };

/// [get: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [set: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
winrt::hstring SearchHistoryContext();

void SearchHistoryContext(winrt::hstring value);

public string SearchHistoryContext { [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")] get; [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")] set; }

var string = searchPane.searchHistoryContext;
searchPane.searchHistoryContext = string;

Public Property SearchHistoryContext As String

Eigenschaftswert

String

Platform::String

winrt::hstring

Die Kontextzeichenfolge für den Suchverlauf.

Attribute

DeprecatedAttribute

Hinweise

Wichtig

Verwenden Sie AutoSuggestBox, um die Suche in einer App für Windows 10 oder höher zu implementieren. Weitere Informationen finden Sie im Feld für automatische Vorschläge .

Sie sollten keine Windows.ApplicationModel.Search-APIs (SearchPane, SearchContract) oder SearchBox-APIs in Apps für Windows 10 oder höher verwenden.

Hinweis

Eine App kann nicht sowohl das Suchfeld (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) als auch die SearchPane verwenden. Wenn Sie sowohl das Suchfeld als auch den Suchbereich in derselben App verwenden, löst die App eine Ausnahme mit der folgenden Meldung aus: "Instanz vom Typ 'Windows.UI.Xaml.Controls.SearchBox' kann nicht erstellt werden."

Die Kontextzeichenfolge des Suchverlaufs wird als sekundärer Schlüssel zum Speichern des Suchverlaufs verwendet (der Primärschlüssel ist die AppId). Eine App kann die Kontextzeichenfolge des Suchverlaufs verwenden, um unterschiedliche Suchverläufe basierend auf dem Kontext der Anwendung zu speichern.

Wenn Sie diese Eigenschaft nicht festlegen, geht Windows davon aus, dass alle Suchvorgänge in Ihrer App im selben Kontext ausgeführt werden. Wenn Sie diese Eigenschaft aktualisieren, während der Suchbereich mit Vorschlägen geöffnet ist, werden die Änderungen erst wirksam, wenn der Benutzer das nächste Zeichen eingibt.

Weitere Informationen

• SearchPane
• SearchHistoryEnabled