DocumentsProvider Klasse

Definition

Namespace:: Android.Provider

Assembly:: Mono.Android.dll

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.

Basisklasse für einen Dokumentanbieter.

[Android.Runtime.Register("android/provider/DocumentsProvider", DoNotGenerateAcw=true)]
public abstract class DocumentsProvider : Android.Content.ContentProvider

[<Android.Runtime.Register("android/provider/DocumentsProvider", DoNotGenerateAcw=true)>]
type DocumentsProvider = class
    inherit ContentProvider

Vererbung: Object

Object

ContentProvider
DocumentsProvider

Attribute: RegisterAttribute

Hinweise

Basisklasse für einen Dokumentanbieter. Ein Dokumentanbieter bietet Lese- und Schreibzugriff auf dauerhafte Dateien, z. B. dateien, die auf einem lokalen Datenträger gespeichert sind, oder Dateien in einem Cloudspeicherdienst. Um einen Dokumentanbieter zu erstellen, erweitern Sie diese Klasse, implementieren Sie die abstrakten Methoden, und fügen Sie sie Ihrem Manifest wie folgt hinzu:

&lt;manifest&gt;
               ...
               &lt;application&gt;
                   ...
                   &lt;provider
                       android:name="com.example.MyCloudProvider"
                       android:authorities="com.example.mycloudprovider"
                       android:exported="true"
                       android:grantUriPermissions="true"
                       android:permission="android.permission.MANAGE_DOCUMENTS"
                       android:enabled="@bool/isAtLeastKitKat"&gt;
                       &lt;intent-filter&gt;
                           &lt;action android:name="android.content.action.DOCUMENTS_PROVIDER" /&gt;
                       &lt;/intent-filter&gt;
                   &lt;/provider&gt;
                   ...
               &lt;/application&gt;
            &lt;/manifest&gt;

Beim Definieren Ihres Anbieters müssen Sie ihn android.Manifest.permission#MANAGE_DOCUMENTSschützen, bei dem es sich nur um eine Berechtigung handelt, die nur vom System erhalten werden kann. Anwendungen können einen Dokumentanbieter nicht direkt verwenden; sie müssen durchlaufen Intent#ACTION_OPEN_DOCUMENT oder Intent#ACTION_CREATE_DOCUMENT erfordern, dass ein Benutzer aktiv in Dokumenten navigiert und dokumente auswählt. Wenn ein Benutzer Dokumente über diese Benutzeroberfläche auswählt, gibt das System schmale URI-Berechtigungserteilungen für die anfordernde Anwendung aus.

<h3>Dokumente</h3>

Ein Dokument kann entweder ein geöffneter Datenstrom (mit einem bestimmten MIME-Typ) oder ein Verzeichnis sein, das zusätzliche Dokumente (mit dem Document#MIME_TYPE_DIR MIME-Typ) enthält. Jedes Verzeichnis stellt den Anfang einer Unterstruktur dar, die null oder mehr Dokumente enthält, die rekursiv noch mehr Dokumente und Verzeichnisse enthalten können.

Jedes Dokument kann unterschiedliche Funktionen aufweisen, wie beschrieben.Document#COLUMN_FLAGS Wenn beispielsweise ein Dokument als Miniaturansicht dargestellt werden kann, kann Ihr Anbieter festlegen Document#FLAG_SUPPORTS_THUMBNAIL und implementieren #openDocumentThumbnail(String, Point, CancellationSignal) , um diese Miniaturansicht zurückzugeben.

Jedes Dokument unter einem Anbieter wird durch sein Document#COLUMN_DOCUMENT_IDDokument eindeutig referenziert, das nicht mehr geändert werden darf, nachdem es zurückgegeben wurde. Ein einzelnes Dokument kann in mehreren Verzeichnissen enthalten sein, wenn auf sie #queryChildDocuments(String, String[], String)reagiert. Beispielsweise kann ein Anbieter ein einzelnes Foto an mehreren Orten anzeigen: einmal in einem Verzeichnis geografischer Standorte und erneut in einem Verzeichnis mit Datumsangaben.

<h3>Wurzeln</h3>

Alle Dokumente werden durch eine oder mehrere "Wurzeln" angezeigt. Jeder Stamm stellt den Anfang einer Dokumentstruktur dar, die ein Benutzer navigieren kann. Ein Stamm kann z. B. ein Konto oder ein physisches Speichergerät darstellen. Ähnlich wie bei Dokumenten kann jeder Stamm über Funktionen verfügen, die durch Root#COLUMN_FLAGSausgedrückt werden.

Java Dokumentation für android.provider.DocumentsProvider.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
DocumentsProvider()
DocumentsProvider(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Eigenschaften

Name	Beschreibung
CallingAttributionSource	Ruft die Attributionsquelle der aufrufenden App ab. (Geerbt von ContentProvider)
CallingAttributionTag	Gibt das Attributionstag des Aufrufers zurück, der die Anforderung initiiert hat, die im aktuellen Thread verarbeitet wird. (Geerbt von ContentProvider)
CallingPackage	Geben Sie den Paketnamen des Aufrufers zurück, der die Anforderung initiiert hat, die im aktuellen Thread verarbeitet wird. (Geerbt von ContentProvider)
CallingPackageUnchecked	Geben Sie den Paketnamen des Aufrufers zurück, der die Anforderung initiiert hat, die im aktuellen Thread verarbeitet wird. (Geerbt von ContentProvider)
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Context	Ruft den Kontext ab, in dem dieser Anbieter ausgeführt wird. (Geerbt von ContentProvider)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
IsTemporary	Gibt true zurück, wenn es sich bei dieser Instanz um einen temporären Inhaltsanbieter handelt. (Geerbt von ContentProvider)
JniIdentityHashCode	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
JniPeerMembers	Basisklasse für einen Dokumentanbieter.
PeerReference	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
ReadPermission	Veraltet. Geben Sie den Namen der berechtigung zurück, die für den schreibgeschützten Zugriff auf diesen Inhaltsanbieter erforderlich ist. - oder - Ändern Sie die berechtigung, die zum Lesen von Daten vom Inhaltsanbieter erforderlich ist. (Geerbt von ContentProvider)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
WritePermission	Veraltet. Geben Sie den Namen der berechtigung zurück, die für den Lese-/Schreibzugriff auf diesen Inhaltsanbieter erforderlich ist. -oder- Ändern Sie die berechtigung, die zum Lesen und Schreiben von Daten im Inhaltsanbieter erforderlich ist. (Geerbt von ContentProvider)

Methoden

Name	Beschreibung
ApplyBatch(IList<ContentProviderOperation>)	Überschreiben Sie dies, um Anforderungen zum Ausführen eines Batches von Vorgängen zu verarbeiten, oder die Standardimplementierung durchläuft die Vorgänge und ruft `ContentProviderOperation#apply` die einzelnen Vorgänge auf. (Geerbt von ContentProvider)
ApplyBatch(String, IList<ContentProviderOperation>)	Überschreiben Sie dies, um Anforderungen zum Ausführen eines Batches von Vorgängen zu verarbeiten, oder die Standardimplementierung durchläuft die Vorgänge und ruft `ContentProviderOperation#apply` die einzelnen Vorgänge auf. (Geerbt von ContentProvider)
AttachInfo(Context, ProviderInfo)	Nach der Instanziierung wird dies aufgerufen, um den Inhaltsanbieter über sich selbst zu informieren. (Geerbt von ContentProvider)
BulkInsert(Uri, ContentValues[])	Überschreiben Sie dies, um Anforderungen zum Einfügen einer Reihe neuer Zeilen zu verarbeiten, oder die Standardimplementierung durchläuft die Werte und aufruft `#insert` die einzelnen Zeilen. (Geerbt von ContentProvider)
Call(String, String, Bundle)	Rufen Sie eine vom Anbieter definierte Methode auf. (Geerbt von ContentProvider)
Call(String, String, String, Bundle)	Rufen Sie eine vom Anbieter definierte Methode auf. (Geerbt von ContentProvider)
Canonicalize(Uri)	Implementieren Sie dies, um die Kanonisierung von URIs zu unterstützen, die auf Ihren Inhaltsanbieter verweisen. (Geerbt von ContentProvider)
ClearCallingIdentity()	Setzen Sie die Identität des eingehenden IPC im aktuellen Thread zurück. (Geerbt von ContentProvider)
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
CopyDocument(String, String)	Kopieren Sie das angeforderte Dokument oder eine Dokumentstruktur.
CreateDocument(String, String, String)	Erstellen Sie ein neues Dokument, und geben Sie das neu generierte `Document#COLUMN_DOCUMENT_ID`Dokument zurück.
CreateWebLinkIntent(String, Bundle)	Erstellt einen Absichtsabsender für einen Weblink, wenn das Dokument weblinkbar ist.
Delete(Uri, Bundle)	Implementieren Sie dies, um Anforderungen zum Löschen einer oder mehrerer Zeilen zu verarbeiten. (Geerbt von ContentProvider)
Delete(Uri, String, String[])	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
DeleteDocument(String)	Löschen Sie das angeforderte Dokument.
Dispose()	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
Dispose(Boolean)	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
Dump(FileDescriptor, PrintWriter, String[])	Drucken Sie den Status des Anbieters in den angegebenen Datenstrom. (Geerbt von ContentProvider)
DumpAsync(FileDescriptor, PrintWriter, String[])	Basisklasse für einen Dokumentanbieter. (Geerbt von ContentProvider)
EjectRoot(String)	Gibt den Stamm aus.
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
FindDocumentPath(String, String)	Sucht den kanonischen Pfad für das angeforderte Dokument.
GetDocumentMetadata(String)	Gibt Metadaten zurück, die dem Dokument zugeordnet sind.
GetDocumentStreamTypes(String, String)	Gibt eine Liste der streambaren MIME-Typen zurück, die dem Filter entsprechen, der an .`#openTypedDocument(String, String, Bundle, CancellationSignal)`
GetDocumentType(String)	Geben Sie den konkreten MIME-Typ des angeforderten Dokuments zurück.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetPathPermissions()	Geben Sie die pfadbasierten Berechtigungen zurück, die für Lese- und/oder Schreibzugriff auf diesen Inhaltsanbieter erforderlich sind. (Geerbt von ContentProvider)
GetStreamTypes(Uri, String)	Wird von einem Client aufgerufen, um die Datentypen von Datenströmen zu bestimmen, die dieser Inhaltsanbieter für den angegebenen URI unterstützt. (Geerbt von ContentProvider)
GetType(Uri)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
GetTypeAnonymous(Uri)	Eine uneingeschränkte Version von getType, die keine vertraulichen Informationen anzeigt
Insert(Uri, ContentValues, Bundle)	Implementieren Sie dies, um Anforderungen zum Einfügen einer neuen Zeile zu verarbeiten. (Geerbt von ContentProvider)
Insert(Uri, ContentValues)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
IsChildDocument(String, String)	Testen Sie, ob ein Dokument absteigend ist (untergeordnetes Kind, Enkelkind usw.) vom angegebenen Übergeordneten.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
MoveDocument(String, String, String)	Verschieben sie das angeforderte Dokument oder eine Dokumentstruktur.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
OnCallingPackageChanged()	Wird immer aufgerufen, wenn der Wert von `#getCallingPackage()` Änderungen geändert wird, sodass der Anbieter die Möglichkeit hat, alle Sicherheitszwischenspeicherung zu ungültig machen, die ausgeführt werden kann. (Geerbt von ContentProvider)
OnConfigurationChanged(Configuration)	Diese Methode wird immer für den Hauptthread der Anwendung aufgerufen und darf keine langwierigen Vorgänge ausführen. (Geerbt von ContentProvider)
OnCreate()	Implementieren Sie dies, um Ihren Inhaltsanbieter beim Start zu initialisieren. (Geerbt von ContentProvider)
OnLowMemory()	Diese Methode wird immer für den Hauptthread der Anwendung aufgerufen und darf keine langwierigen Vorgänge ausführen. (Geerbt von ContentProvider)
OnTrimMemory(TrimMemory)	Wird aufgerufen, wenn das Betriebssystem festgestellt hat, dass es eine gute Zeit für einen Prozess ist, nicht benötigte Arbeitsspeicher aus seinem Prozess zu kürzen. (Geerbt von ContentProvider)
OpenAssetFile(Uri, String, CancellationSignal)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
OpenAssetFile(Uri, String)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
OpenDocument(String, String, CancellationSignal)	Öffnen sie das angeforderte Dokument, und geben Sie es zurück.
OpenDocumentThumbnail(String, Point, CancellationSignal)	Öffnen sie eine Miniaturansicht des angeforderten Dokuments, und geben Sie sie zurück.
OpenFile(Uri, String, CancellationSignal)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
OpenFile(Uri, String)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
OpenFileHelper(Uri, String)	Komfort für Unterklassen, die implementiert `#openFile` werden sollen, indem sie eine Spalte mit dem Namen "_data" am angegebenen URI nachschlagen. (Geerbt von ContentProvider)
OpenPipeHelper(Uri, String, Bundle, Object, ContentProvider+IPipeDataWriter)	Eine Hilfsfunktion für die Implementierung `#openTypedAssetFile`, zum Erstellen einer Datenpipeline und eines Hintergrundthreads, mit der Sie generierte Daten zurück an den Client streamen können. (Geerbt von ContentProvider)
OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
OpenTypedAssetFile(Uri, String, Bundle)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
OpenTypedDocument(String, String, Bundle, CancellationSignal)	Öffnen Sie das Dokument, und geben Sie es in einem Format zurück, das dem angegebenen MIME-Typfilter entspricht.
Query(Uri, String[], Bundle, CancellationSignal)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
Query(Uri, String[], String, String[], String, CancellationSignal)	Implementieren Sie dies zum Behandeln von Abfrageanforderungen von Clients mit Unterstützung für den Abbruch. (Geerbt von ContentProvider)
Query(Uri, String[], String, String[], String)	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
QueryChildDocuments(String, String[], Bundle)	Überschreiben Sie diese Methode, um die untergeordneten Dokumente im angeforderten Verzeichnis zurückzugeben.
QueryChildDocuments(String, String[], String)	Gibt die untergeordneten Dokumente zurück, die im angeforderten Verzeichnis enthalten sind.
QueryDocument(String, String[])	Gibt Metadaten für das einzelne angeforderte Dokument zurück.
QueryRecentDocuments(String, String[], Bundle, CancellationSignal)	Geben Sie zuletzt geänderte Dokumente unter dem angeforderten Stamm zurück.
QueryRecentDocuments(String, String[])	Geben Sie zuletzt geänderte Dokumente unter dem angeforderten Stamm zurück.
QueryRoots(String[])	Gibt alle zurzeit bereitgestellten Wurzeln zurück.
QuerySearchDocuments(String, String, String[])	Gibt Dokumente zurück, die der angegebenen Abfrage unter dem angeforderten Stamm entsprechen.
QuerySearchDocuments(String, String[], Bundle)	Gibt Dokumente zurück, die der angegebenen Abfrage unter dem angeforderten Stamm entsprechen.
Refresh(Uri, Bundle, CancellationSignal)	Implementieren Sie dies, um die Aktualisierung von Inhalten zu unterstützen, die von `uri`. (Geerbt von ContentProvider)
RemoveDocument(String, String)	Entfernt das angeforderte Dokument oder eine Dokumentstruktur.
RenameDocument(String, String)	Benennen Sie ein vorhandenes Dokument um.
RequireContext()	Ruft einen nicht nullfähigen Kontext ab, in dem dieser Anbieter ausgeführt wird, dies soll nach aufgerufen `#onCreate`werden. (Geerbt von ContentProvider)
RestoreCallingIdentity(ContentProvider+CallingIdentity)	Stellen Sie die Identität des eingehenden IPC im aktuellen Thread wieder auf eine zuvor zurückgegebene `#clearCallingIdentity`Identität zurück. (Geerbt von ContentProvider)
RevokeDocumentPermission(String)	Widerrufen Sie alle aktiven Berechtigungserteilungen für den angegebenen `Document#COLUMN_DOCUMENT_ID`, normalerweise aufgerufen, wenn ein Dokument ungültig wird.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetPathPermissions(PathPermission[])	Ändern Sie die pfadbasierte Berechtigung, die zum Lesen und/oder Schreiben von Daten im Inhaltsanbieter erforderlich ist. (Geerbt von ContentProvider)
SetReadPermission(String)	Basisklasse für einen Dokumentanbieter. (Geerbt von ContentProvider)
SetWritePermission(String)	Basisklasse für einen Dokumentanbieter. (Geerbt von ContentProvider)
Shutdown()	Implementieren Sie dies, um die ContentProvider-Instanz herunterzufahren. (Geerbt von ContentProvider)
ToArray<T>()	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
Uncanonicalize(Uri)	Entfernen Sie kanonische UrIs, die zuvor von `#canonicalize`. (Geerbt von ContentProvider)
UnregisterFromRuntime()	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
Update(Uri, ContentValues, Bundle)	Implementieren Sie dies, um Anforderungen zum Aktualisieren einer oder mehrerer Zeilen zu verarbeiten. (Geerbt von ContentProvider)
Update(Uri, ContentValues, String, String[])	Die Implementierung wird von der übergeordneten Klasse bereitgestellt.
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
IJavaPeerable.Finalized()	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Basisklasse für einen Dokumentanbieter. (Geerbt von Object)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Basisklasse für einen Dokumentanbieter.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: