ContentIndexer Klasse
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.
Ermöglicht es UWP-Apps, private Inhalte mithilfe des Systemindexes durchsuchbar zu machen.
public ref class ContentIndexer sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContentIndexer final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContentIndexer
Public NotInheritable Class ContentIndexer
- Vererbung
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Beispiele
Inhaltsindexerbeispiel (Windows 10)
Video Exemplarische Vorgehensweise einer Demo-App
Hinweise
Mit der ContentIndexer-Klasse können Apps einen Eigenschaftenbehälter in den Systemindex pushen, der später von der App oder dem Benutzer schnell durchsucht werden kann. Der Eigenschaftenbehälter kann alle Eigenschaften aus dem Shelleigenschaftensystem enthalten und kann sofort nach der Rückgabe des API-Aufrufs gesucht werden.
Die Eigenschaften werden als Zeichenfolgen-Objekt-Schlüssel-Wert-Paare definiert, wobei es sich bei den Schlüsseln um Windows-Standardeigenschaftennamen handelt, z . B. System.Author, und die Werte sind PropertyValue-Instanzen . Die Eigenschaft muss auf dem System registriert sein und isColumn und isInvertedIndex auf true festgelegt sein. Sie können auch Inhalte für die Volltextsuche bereitstellen, indem Sie einen Stream und einen Inhaltstyp verwenden. Dies entspricht der Ausführung der IFilter-Implementierung für den Typ und dem Indizieren des Inhalts.
Sie können Inhalte mithilfe der erweiterten Abfragesyntax (Advanced Query Syntax, AQS) abfragen.
Verwenden Sie den Index nicht als primären Datenspeicher, der Index ist nur ein Cache mit durchsuchbaren Eigenschaften. Alle Daten im Index müssen an anderer Stelle gespeichert werden, falls der Cache verloren geht. Inhalte werden nach App-Paket und Benutzer getrennt. Ein Paket kann die Daten eines anderen Pakets nicht abfragen, aber das Betriebssystem kann auf alle Daten zugreifen, die per Push übertragen werden.
Weitere Informationen zu den verfügbaren Eigenschaften finden Sie im Windows-Eigenschaftensystem.
Eigenschaften
Revision |
Ruft die Version des ContentIndexer ab. |
Methoden
AddAsync(IIndexableContent) |
Fügt dem Systemindex appdefinierte Elemente mit Eigenschaften und Inhalten hinzu. |
CreateQuery(String, IIterable<String>) |
Erstellt eine Abfrage mit dem angegebenen Suchfilter und identifiziert die abzurufenden Eigenschaften. |
CreateQuery(String, IIterable<String>, IIterable<SortEntry>) |
Erstellt eine Abfrage mit dem angegebenen Suchfilter, sortierreihenfolge und gibt an, welche Eigenschaften abgerufen werden sollen. |
CreateQuery(String, IIterable<String>, IIterable<SortEntry>, String) |
Erstellt eine Abfrage mit dem angegebenen Suchfilter, der angegebenen Sortierreihenfolge und der Filtersprache und identifiziert die abzurufenden Eigenschaften. |
DeleteAllAsync() |
Entfernt alle app-definierten Elemente aus dem ContentIndexer. |
DeleteAsync(String) |
Entfernt das angegebene app-definierte Element aus dem ContentIndexer. |
DeleteMultipleAsync(IIterable<String>) |
Entfernt die angegebenen app-definierten Elemente aus dem ContentIndexer. |
GetIndexer() |
Ruft einen vorhandenen App-Index ab, oder erstellt bei Bedarf einen neuen Index. |
GetIndexer(String) |
Ruft den App-Index mit dem angegebenen Namen ab oder erstellt bei Bedarf einen neuen Index. |
RetrievePropertiesAsync(String, IIterable<String>) |
Ruft Inhaltseigenschaften basierend auf dem angegebenen Inhaltsbezeichner ab. |
UpdateAsync(IIndexableContent) |
Updates App-Inhalte und -Eigenschaften im ContentIndexer. |