ContentProvider Class

Definition

Content providers are one of the primary building blocks of Android applications, providing content to applications.

[Android.Runtime.Register("android/content/ContentProvider", DoNotGenerateAcw=true)]
public abstract class ContentProvider : Java.Lang.Object, Android.Content.IComponentCallbacks2, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/content/ContentProvider", DoNotGenerateAcw=true)>]
type ContentProvider = class
    inherit Object
    interface IComponentCallbacks
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComponentCallbacks2
Inheritance
ContentProvider
Derived
Attributes
Implements

Remarks

Java documentation for android.content.ContentProvider.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

ContentProvider()

Construct a ContentProvider instance.

ContentProvider(IntPtr, JniHandleOwnership)

A constructor used when creating managed representations of JNI objects; called by the runtime.

Properties

CallingAttributionSource

Gets the attribution source of the calling app.

CallingAttributionTag

Return the attribution tag of the caller that initiated the request being processed on the current thread.

CallingPackage

Return the package name of the caller that initiated the request being processed on the current thread.

CallingPackageUnchecked

Return the package name of the caller that initiated the request being processed on the current thread.

Class

Returns the runtime class of this Object.

(Inherited from Object)
Context

Retrieves the Context this provider is running in.

Handle

The handle to the underlying Android instance.

(Inherited from Object)
IsTemporary

Returns true if this instance is a temporary content provider.

JniIdentityHashCode (Inherited from Object)
JniPeerMembers
PeerReference (Inherited from Object)
ReadPermission

Return the name of the permission required for read-only access to this content provider. -or- Change the permission required to read data from the content provider.

ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

WritePermission

Return the name of the permission required for read/write access to this content provider. -or- Change the permission required to read and write data in the content provider.

Methods

ApplyBatch(IList<ContentProviderOperation>)

Override this to handle requests to perform a batch of operations, or the default implementation will iterate over the operations and call ContentProviderOperation#apply on each of them.

ApplyBatch(String, IList<ContentProviderOperation>)

Override this to handle requests to perform a batch of operations, or the default implementation will iterate over the operations and call ContentProviderOperation#apply on each of them.

AttachInfo(Context, ProviderInfo)

After being instantiated, this is called to tell the content provider about itself.

BulkInsert(Uri, ContentValues[])

Override this to handle requests to insert a set of new rows, or the default implementation will iterate over the values and call #insert on each of them.

Call(String, String, Bundle)

Call a provider-defined method.

Call(String, String, String, Bundle)

Call a provider-defined method.

Canonicalize(Uri)

Implement this to support canonicalization of URIs that refer to your content provider.

ClearCallingIdentity()

Reset the identity of the incoming IPC on the current thread.

Clone()

Creates and returns a copy of this object.

(Inherited from Object)
Delete(Uri, Bundle)
Delete(Uri, String, String[])

Implement this to handle requests to delete one or more rows.

Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
Dump(FileDescriptor, PrintWriter, String[])

Print the Provider's state into the given stream.

DumpAsync(FileDescriptor, PrintWriter, String[])
Equals(Object)

Indicates whether some other object is "equal to" this one.

(Inherited from Object)
GetHashCode()

Returns a hash code value for the object.

(Inherited from Object)
GetPathPermissions()

Return the path-based permissions required for read and/or write access to this content provider.

GetStreamTypes(Uri, String)

Called by a client to determine the types of data streams that this content provider supports for the given URI.

GetType(Uri)

Implement this to handle requests for the MIME type of the data at the given URI.

Insert(Uri, ContentValues)

Implement this to handle requests to insert a new row.

Insert(Uri, ContentValues, Bundle)

Implement this to handle requests to insert a new row.

JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
OnCallingPackageChanged()

Called whenever the value of #getCallingPackage() changes, giving the provider an opportunity to invalidate any security related caching it may be performing.

OnConfigurationChanged(Configuration)

[TODO: @inheritDoc] This method is always called on the application main thread, and must not perform lengthy operations.

OnCreate()

Implement this to initialize your content provider on startup.

OnLowMemory()

[TODO: @inheritDoc] This method is always called on the application main thread, and must not perform lengthy operations.

OnTrimMemory(TrimMemory)

Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.

OpenAssetFile(Uri, String)

This is like #openFile, but can be implemented by providers that need to be able to return sub-sections of files, often assets inside of their .

OpenAssetFile(Uri, String, CancellationSignal)

This is like #openFile, but can be implemented by providers that need to be able to return sub-sections of files, often assets inside of their .

OpenFile(Uri, String)

Override this to handle requests to open a file blob.

OpenFile(Uri, String, CancellationSignal)

Override this to handle requests to open a file blob.

OpenFileHelper(Uri, String)

Convenience for subclasses that wish to implement #openFile by looking up a column named "_data" at the given URI.

OpenPipeHelper(Uri, String, Bundle, Object, ContentProvider+IPipeDataWriter)

A helper function for implementing #openTypedAssetFile, for creating a data pipe and background thread allowing you to stream generated data back to the client.

OpenTypedAssetFile(Uri, String, Bundle)

Called by a client to open a read-only stream containing data of a particular MIME type.

OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal)

Called by a client to open a read-only stream containing data of a particular MIME type.

Query(Uri, String[], Bundle, CancellationSignal)

Implement this to handle query requests where the arguments are packed into a Bundle.

Query(Uri, String[], String, String[], String)

Implement this to handle query requests from clients.

Query(Uri, String[], String, String[], String, CancellationSignal)

Implement this to handle query requests from clients with support for cancellation.

Refresh(Uri, Bundle, CancellationSignal)

Implement this to support refresh of content identified by uri.

RequireContext()

Retrieves a Non-Nullable Context this provider is running in, this is intended to be called after #onCreate.

RestoreCallingIdentity(ContentProvider+CallingIdentity)

Restore the identity of the incoming IPC on the current thread back to a previously identity that was returned by #clearCallingIdentity.

SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
SetPathPermissions(PathPermission[])

Change the path-based permission required to read and/or write data in the content provider.

SetReadPermission(String)
SetWritePermission(String)
Shutdown()

Implement this to shut down the ContentProvider instance.

ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
Uncanonicalize(Uri)

Remove canonicalization from canonical URIs previously returned by #canonicalize.

UnregisterFromRuntime() (Inherited from Object)
Update(Uri, ContentValues, Bundle)

Implement this to handle requests to update one or more rows.

Update(Uri, ContentValues, String, String[])

Implement this to handle requests to update one or more rows.

Wait()

Causes the current thread to wait until another thread invokes the java.lang.Object#notify() method or the java.lang.Object#notifyAll() method for this object.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until either another thread invokes the java.lang.Object#notify() method or the java.lang.Object#notifyAll() method for this object, or a specified amount of time has elapsed.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until another thread invokes the java.lang.Object#notify() method or the java.lang.Object#notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.

(Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to