SliceProvider Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
A SliceProvider allows an app to provide content to be displayed in system spaces.
[Android.Runtime.Register("android/app/slice/SliceProvider", ApiSince=28, DoNotGenerateAcw=true)]
public abstract class SliceProvider : Android.Content.ContentProvider[<Android.Runtime.Register("android/app/slice/SliceProvider", ApiSince=28, DoNotGenerateAcw=true)>]
type SliceProvider = class
inherit ContentProvider- Inheritance
- Attributes
Remarks
A SliceProvider allows an app to provide content to be displayed in system spaces. This content is templated and can contain actions, and the behavior of how it is surfaced is specific to the system surface.
Slices are not currently live content. They are bound once and shown to the user. If the content changes due to a callback from user interaction, then ContentResolver#notifyChange(Uri, ContentObserver) should be used to notify the system.
The provider needs to be declared in the manifest to provide the authority for the app. The authority for most slices is expected to match the package of the application.
{@literal
<provider
android:name="com.example.mypkg.MySliceProvider"
android:authorities="com.example.mypkg" />}
Slices can be identified by a Uri or by an Intent. To link an Intent with a slice, the provider must have an IntentFilter matching the slice intent. When a slice is being requested via an intent, #onMapIntentToUri(Intent) can be called and is expected to return an appropriate Uri representing the slice.
{@literal
<provider
android:name="com.example.mypkg.MySliceProvider"
android:authorities="com.example.mypkg">
<intent-filter>
<action android:name="com.example.mypkg.intent.action.MY_SLICE_INTENT" />
<category android:name="android.app.slice.category.SLICE" />
</intent-filter>
</provider>}
Java documentation for android.app.slice.SliceProvider.
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
| SliceProvider() |
A version of constructing a SliceProvider that allows autogranting slice permissions to apps that hold specific platform permissions. |
| SliceProvider(IntPtr, JniHandleOwnership) | |
| SliceProvider(String[]) |
A version of constructing a SliceProvider that allows autogranting slice permissions to apps that hold specific platform permissions. |
Fields
| SliceType |
This is the Android platform's MIME type for a URI
containing a slice implemented through |
Properties
| CallingAttributionSource |
Gets the attribution source of the calling app. (Inherited from ContentProvider) |
| CallingAttributionTag |
Return the attribution tag of the caller that initiated the request being processed on the current thread. (Inherited from ContentProvider) |
| CallingPackage |
Return the package name of the caller that initiated the request being processed on the current thread. (Inherited from ContentProvider) |
| CallingPackageUnchecked |
Return the package name of the caller that initiated the request being processed on the current thread. (Inherited from ContentProvider) |
| Class |
Returns the runtime class of this |
| Context |
Retrieves the Context this provider is running in. (Inherited from ContentProvider) |
| Handle |
The handle to the underlying Android instance. (Inherited from Object) |
| IsTemporary |
Returns true if this instance is a temporary content provider. (Inherited from ContentProvider) |
| JniIdentityHashCode | (Inherited from Object) |
| JniPeerMembers | |
| PeerReference | (Inherited from Object) |
| ReadPermission |
Obsolete.
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. (Inherited from ContentProvider) |
| ThresholdClass | |
| ThresholdType | |
| WritePermission |
Obsolete.
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. (Inherited from ContentProvider) |
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
|
| 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
|
| AttachInfo(Context, ProviderInfo) |
After being instantiated, this is called to tell the content provider about itself. (Inherited from ContentProvider) |
| 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
|
| Call(String, String, Bundle) |
Call a provider-defined method. (Inherited from ContentProvider) |
| Call(String, String, String, Bundle) |
Call a provider-defined method. (Inherited from ContentProvider) |
| Canonicalize(Uri) |
Implement this to support canonicalization of URIs that refer to your content provider. (Inherited from ContentProvider) |
| ClearCallingIdentity() |
Reset the identity of the incoming IPC on the current thread. (Inherited from ContentProvider) |
| Clone() |
Creates and returns a copy of this object. (Inherited from Object) |
| Delete(Uri, Bundle) |
Implement this to handle requests to delete one or more rows. (Inherited from ContentProvider) |
| Delete(Uri, String, String[]) | |
| Dispose() | (Inherited from Object) |
| Dispose(Boolean) | (Inherited from Object) |
| Dump(FileDescriptor, PrintWriter, String[]) |
Print the Provider's state into the given stream. (Inherited from ContentProvider) |
| DumpAsync(FileDescriptor, PrintWriter, String[]) | (Inherited from ContentProvider) |
| 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. (Inherited from ContentProvider) |
| GetStreamTypes(Uri, String) |
Called by a client to determine the types of data streams that this content provider supports for the given URI. (Inherited from ContentProvider) |
| GetType(Uri) | |
| GetTypeAnonymous(Uri) |
Implement this to handle requests for MIME type of URIs, that does not need to reveal any internal information which should be protected by any permission. (Inherited from ContentProvider) |
| Insert(Uri, ContentValues) | |
| Insert(Uri, ContentValues, Bundle) |
Implement this to handle requests to insert a new row. (Inherited from ContentProvider) |
| 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) |
| OnBindSlice(Uri, ICollection<SliceSpec>) |
Implemented to create a slice. |
| OnCallingPackageChanged() |
Called whenever the value of |
| OnConfigurationChanged(Configuration) |
To be added This method is always called on the application main thread, and must not perform lengthy operations. (Inherited from ContentProvider) |
| OnCreate() |
Implement this to initialize your content provider on startup. (Inherited from ContentProvider) |
| OnCreatePermissionRequest(Uri) |
Called when an app requests a slice it does not have write permission to the uri for. |
| OnGetSliceDescendants(Uri) |
Obtains a list of slices that are descendants of the specified Uri. |
| OnLowMemory() |
To be added This method is always called on the application main thread, and must not perform lengthy operations. (Inherited from ContentProvider) |
| OnMapIntentToUri(Intent) |
This method must be overridden if an |
| OnSlicePinned(Uri) |
Called to inform an app that a slice has been pinned. |
| OnSliceUnpinned(Uri) |
Called to inform an app that a slices is no longer pinned. |
| 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. (Inherited from ContentProvider) |
| OpenAssetFile(Uri, String) |
This is like |
| OpenAssetFile(Uri, String, CancellationSignal) |
This is like |
| OpenFile(Uri, String) |
Override this to handle requests to open a file blob. (Inherited from ContentProvider) |
| OpenFile(Uri, String, CancellationSignal) |
Override this to handle requests to open a file blob. (Inherited from ContentProvider) |
| OpenFileHelper(Uri, String) |
Convenience for subclasses that wish to implement |
| OpenPipeHelper(Uri, String, Bundle, Object, ContentProvider+IPipeDataWriter) |
A helper function for implementing |
| OpenTypedAssetFile(Uri, String, Bundle) |
Called by a client to open a read-only stream containing data of a particular MIME type. (Inherited from ContentProvider) |
| OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal) |
Called by a client to open a read-only stream containing data of a particular MIME type. (Inherited from ContentProvider) |
| Query(Uri, String[], Bundle, CancellationSignal) | |
| Query(Uri, String[], String, String[], String) | |
| Query(Uri, String[], String, String[], String, CancellationSignal) | |
| Refresh(Uri, Bundle, CancellationSignal) |
Implement this to support refresh of content identified by |
| RequireContext() |
Retrieves a Non-Nullable Context this provider is running in, this is intended to be called
after |
| RestoreCallingIdentity(ContentProvider+CallingIdentity) |
Restore the identity of the incoming IPC on the current thread back to a
previously identity that was returned by |
| 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. (Inherited from ContentProvider) |
| SetReadPermission(String) | (Inherited from ContentProvider) |
| SetWritePermission(String) | (Inherited from ContentProvider) |
| Shutdown() |
Implement this to shut down the ContentProvider instance. (Inherited from ContentProvider) |
| 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
|
| UnregisterFromRuntime() | (Inherited from Object) |
| Update(Uri, ContentValues, Bundle) |
Implement this to handle requests to update one or more rows. (Inherited from ContentProvider) |
| Update(Uri, ContentValues, String, String[]) | |
| Wait() |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object) |
| Wait(Int64) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
| Wait(Int64, Int32) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until 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) | |