This topic has not yet been rated - Rate this topic

DeviceExtendedProperties.GetValue Method

July 26, 2012

Retrieves an object representing the specified device property.

Namespace:  Microsoft.Phone.Info
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)
public static Object GetValue(
	string propertyName
)

Parameters

propertyName
Type: System.String
The name of the device property to be retrieved. Property names are case-sensitive.

Return Value

Type: System.Object
Returns Object.
Caution noteCaution:

In Windows Phone OS 7.0, the DeviceExtendedProperties class was used to query device-specific properties. In Windows Phone OS 7.1, most of the properties in DeviceExtendedProperties were deprecated, and the new DeviceStatus class should be used instead. However, where appropriate, you can still use the properties in DeviceExtendedProperties that are not deprecated.

For a full list of properties that can be queried by this method, see DeviceExtendedProperties.

GetValue(String) either will return a non-null object containing the requested value or will throw one of the exceptions listed in the following table. TryGetValue(String, Object) provides the same functionality as GetValue(String), but uses a different syntax that you may prefer.

Important noteImportant Note:

DeviceExtendedProperties requires the device identity capability. If your application uses this class, the user will be alerted that the application requires access to the device identity when viewing your application on Windows Phone Marketplace. However, if you use the GetValue method to get the ApplicationWorkingSetLimit, you can opt out of the device identity capability by removing it from the application manifest prior to application ingestion and it will not be added back in during the ingestion process.

This method may throw one of the following exceptions.

ArgumentNullException

The specified property name is null.

ArgumentOutOfRangeException

The specified property does not exist.

UnauthorizedAccessException

The capability to retrieve the property has not been granted.

NotSupportedException

The specified property cannot be retrieved.

Windows Phone OS

Supported in: 7.1, 7.0

Windows Phone

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.