Class AppControl.ExtraDataCollection

Definition

Namespace:: Tizen.Applications

Assembly:: Tizen.Applications.Common.dll

API Level:: 3

Class for extra data.


                C#
                
                    Copy
                    
                
            
public class ExtraDataCollection

Inheritance: System.Object

AppControl.ExtraDataCollection

Methods

View Source

Add(String, IEnumerable<String>)

Adds extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public void Add(string key, IEnumerable<string> value)

Parameters

Type	Name	Description
System.String	key	The name of the extra data.
System.Collections.Generic.IEnumerable<System.String>	value	The value associated with the given key.

Remarks

The function replaces any existing value for the given key.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
string[] myValues = new string[] { "first", "second", "third" };
appControl.ExtraData.Add("myKey", myValues);

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when key or value is a zero-length string.
System.ArgumentException	Thrown when the application tries to use the same key with the system-defined key.

API Level: 3

View Source

Add(String, String)

Adds extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public void Add(string key, string value)

Parameters

Type	Name	Description
System.String	key	The name of the extra data.
System.String	value	The value associated with the given key.

Remarks

The function replaces any existing value for the given key.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
appControl.ExtraData.Add("myKey", "myValue");

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when a key or a value is a zero-length string.
System.ArgumentException	Thrown when the application tries to use the same key with the system-defined key.

API Level: 3

View Source

Count()

Counts keys in the extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public int Count()

Returns

Type	Description
Int32	The number of counting keys.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
int numberOfKeys = appControl.ExtraData.Count();

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when the key is an invalid parameter.

API Level: 3

View Source

Get(String)

Gets the extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public object Get(string key)

Parameters

Type	Name	Description
System.String	key	The name of extra data.

Returns

Type	Description
System.Object	The value associated with the given key.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
string myValue = appControl.ExtraData.Get("myKey") as string;
if (myValue != null)
{
    // ...
}

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when the key is an invalid parameter.
KeyNotFoundException	Thrown when the key is not found.
System.ArgumentException	Thrown when the key is rejected.

API Level: 3

View Source

Get<T>(String)

Gets the extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public T Get<T>(string key)

Parameters

Type	Name	Description
System.String	key	The name of extra data.

Returns

Type	Description
T	The value associated with the given key.

Type Parameters

Name	Description
T	Only string and IEnumerable<string>

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
string myValue = appControl.ExtraData.Get<string>("myKey");

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when the key is an invalid parameter.
KeyNotFoundException	Thrown when the key is not found.
System.ArgumentException	Thrown when the key is rejected.

API Level: 3

View Source

GetKeys()

Gets all keys in extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public IEnumerable<string> GetKeys()

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.String>	The keys in the AppControl.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
IEnumerable<string> keys = appControl.GetKeys();
if (keys != null)
{
    foreach (string key in keys)
    {
        // ...
    }
}

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when the key is an invalid parameter.

API Level: 3

View Source

IsCollection(String)

Checks whether the extra data associated with the given key is of the collection data type.

Declaration


                C#
                
                    Copy
                    
                
            
public bool IsCollection(string key)

Parameters

Type	Name	Description
System.String	key	The name of the extra data.

Returns

Type	Description
Boolean	If true, the extra data is of the array data type, otherwise false.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
bool result = appControl.ExtraData.IsCollection("myKey");

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when the key is a zero-length string.
System.InvalidOperationException	Thrown when failed to check the key.

API Level: 3

View Source

Remove(String)

Removes the extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public void Remove(string key)

Parameters

Type	Name	Description
System.String	key	The name of the extra data.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
appControl.ExtraData.Remove("myKey");

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when the key is a zero-length string.
KeyNotFoundException	Thrown when the key is not found.
System.ArgumentException	Thrown when the key is rejected.

API Level: 3

View Source

TryGet(String, out IEnumerable<String>)

Tries getting the extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public bool TryGet(string key, out IEnumerable<string> value)

Parameters

Type	Name	Description
System.String	key	The name of extra data.
System.Collections.Generic.IEnumerable<System.String>	value	The value associated with the given key.

Returns

Type	Description
Boolean	The result whether getting the value is done.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
IEnumerable<string> myValue = null;
bool result = appControl.ExtraData.TryGet("myKey", out myValue);
if (result)
{
    foreach (string value in myValue)
    {
        // ...
    }
}

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when the key is an invalid parameter.
KeyNotFoundException	Thrown when the key is not found.
System.ArgumentException	Thrown when the key is rejected.

API Level: 3

View Source

TryGet(String, out String)

Tries getting the extra data.

Declaration


                C#
                
                    Copy
                    
                
            
public bool TryGet(string key, out string value)

Parameters

Type	Name	Description
System.String	key	The name of extra data.
System.String	value	The value associated with the given key.

Returns

Type	Description
Boolean	The result whether getting the value is done.

Examples


                
                
                    Copy
                    
                
            
AppControl appControl = new AppControl();
string myValue = string.Empty;
bool result = appControl.ExtraData.TryGet("myKey", out myValue);
if (result != null)
{
    // ...
}

Exceptions

Type	Condition
System.ArgumentNullException	Thrown when the key is an invalid parameter.
KeyNotFoundException	Thrown when the key is not found.
System.ArgumentException	Thrown when the key is rejected.