Class Storage

Definition

Namespace:

Tizen.System

Assembly:

Tizen.System.Storage.dll

The class to access the storage device information.

public class Storage

Inheritance

object

Storage

Properties

AvailableSpace

The available storage size in bytes. The type of value is ulong.

Declaration

public ulong AvailableSpace { get; }

Property Value

Type	Description
ulong

AvaliableSpace

[Obsolete("Please do not use! this will be deprecated")]

Declaration

[Obsolete("Please do not use! This will be deprecated! Please use AvailableSpace instead!")]
public ulong AvaliableSpace { get; }

Property Value

Type	Description
ulong

DeviceType

The StorageDevice. It indicates information such as sdcard or USB storage.

Declaration

public StorageDevice DeviceType { get; }

Property Value

Type	Description
StorageDevice

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when DeviceType is not initialized.

Flags

The flags for the storage status. It is a piece of information representing storage.

Declaration

public int Flags { get; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when flags are not initialized.

Fstype

The type of file system. For example, it can be ext3 or ext4.

Declaration

public string Fstype { get; }

Property Value

Type	Description
string

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when Fstype is not initialized.

Fsuuid

The UUID of the file system. It is a unique value that serves as immutable identifier.

Declaration

public string Fsuuid { get; }

Property Value

Type	Description
string

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when Fsuuid is not initialized.

Id

The storage ID. It is the identifier used to determine whether the corresponding storage is internal or external.

Declaration

public int Id { get; }

Property Value

Type	Description
int

Primary

Information whether this is a primary partition or not.

Declaration

public bool Primary { get; }

Property Value

Type	Description
bool

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when primary is not initialized.

RootDirectory

The root directory for the storage. It generally has an absolute path.

Declaration

public string RootDirectory { get; }

Property Value

Type	Description
string

State

The StorageState. It contains information about the mounted state of the storage.

Declaration

public StorageState State { get; }

Property Value

Type	Description
StorageState

StorageType

The type of storage. It has one of three values: internal, external or extended internal.

Declaration

public StorageArea StorageType { get; }

Property Value

Type	Description
StorageArea

TotalSpace

The total storage space in bytes. The type of value is ulong.

Declaration

public ulong TotalSpace { get; }

Property Value

Type	Description
ulong

Methods

GetAbsolutePath(DirectoryType)

Gets the absolute path to the root directory of the given storage.

Declaration

public string GetAbsolutePath(DirectoryType dirType)

Parameters

Type	Name	Description
DirectoryType	dirType	Directory type.

Returns

Type	Description
string	Absolute path for a given directory type in the storage.

Remarks

The returned directory path may not exist, so you must make sure that it exists before using it. For accessing internal storage except the ringtones directory, the application should have http://tizen.org/privilege/mediastorage privilege. For accessing ringtones directory, the application should have http://tizen.org/privilege/systemsettings privilege. For accessing external storage, the application should have http://tizen.org/privilege/externalstorage privilege.

Examples

// To get the video directories for all the supported storage,
var storageList = StorageManager.Storages as List<Storage>;
foreach (var storage in storageList)
{
    string pathForVideoDir = storage.GetAbsolutePath(DirectoryType.Videos);
}

Exceptions

Type	Condition
System.ArgumentException	Thrown when failed because of an invalid argument.
System.OutOfMemoryException	Thrown when failed due to out of memory exception.
System.NotSupportedException	Thrown when the storage is not supported or the application does not have the permission to access the directory path.

Events

StorageStateChanged

StorageStateChanged event. This event is occurred when a storage state changes.

Declaration

public event EventHandler StorageStateChanged

Event Type

Type	Description
System.EventHandler

Remarks

The storage state will be updated before calling the event handler.

Examples

myStorage.StorageStateChanged += (s, e) =>
{
    var storage = s as Storage;
    Console.WriteLine(string.Format("State Changed to {0}", storage.State));
}