AppDataFileSource Class

Definition

[Android.Runtime.Register("android/os/storage/operations/sources/AppDataFileSource", ApiSince=37, DoNotGenerateAcw=true)]
public sealed class AppDataFileSource : Android.OS.Storage.Operations.Sources.OperationSource

[<Android.Runtime.Register("android/os/storage/operations/sources/AppDataFileSource", ApiSince=37, DoNotGenerateAcw=true)>]
type AppDataFileSource = class
    inherit OperationSource

Inheritance

Object

JavaObject

Object

OperationSource

AppDataFileSource

Attributes

RegisterAttribute

Remarks

A source representing a file within the calling application's private app data directory.

This source is restricted to files located inside the application's internal data directory (as returned by Context.getDataDir()). Operation Rejection

To ensure system security and integrity, operations using an AppDataFileSource will be rejected with FileOperationResult.ERROR_UNSUPPORTED_SOURCE or FileOperationResult.ERROR_INVALID_REQUEST if: The provided path is not absolute; The path contains path traversal elements (e.g., "..") or redundant segments; The path contains unsafe control characters (e.g., null, newline); The file is outside the application's internal data directory (CE or DE storage). Locations such as external storage or system directories are strictly prohibited.

// Obtain the application's data directory using Context
Context context = getApplicationContext();
File myDataFile = new File(context.getDataDir(), "subfolder/my_data.txt");

// Construct the AppDataFileSource with the File object
AppDataFileSource source = new AppDataFileSource(myDataFile);

// The source can now be used in storage operations

Android reference for android.os.storage.operations.sources.AppDataFileSource.

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.