UserExtendedProperties.TryGetValue Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Retrieves an object representing the specified user property. The two available properties are ANID and ANID2.

Namespace:  Microsoft.Phone.Info
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)

Syntax

Public Shared Function TryGetValue ( _
    propertyName As String, _
    <OutAttribute> ByRef propertyValue As Object _
) As Boolean
public static bool TryGetValue(
    string propertyName,
    out Object propertyValue
)

Parameters

  • propertyName
    Type: System..::.String
    The name of the user property to be retrieved. Property names are case-sensitive.
  • propertyValue
    Type: System..::.Object%
    The output parameter object in which the value of the device property is stored.

Return Value

Type: System..::.Boolean
true if the specified property was successfully retrieved; otherwise, false.

Exceptions

Exception Condition
ArgumentNullException

The specified property name is null.

Remarks

The UserExtendedProperties API exposes two properties: ANID and ANID2.

  • ANID can only be accessed from Windows Phone OS 7.0 and Windows Phone OS 7.1 apps that use the Microsoft Advertising SDK for Windows Phone.

  • ANID2 can only be accessed from Windows Phone 8 apps.

The string returned by the ANID and ANID2 properties contains the anonymous identifier and is 32 characters long.

GetValue(String) provides the same functionality as TryGetValue(String, Object%), but uses a different syntax that you may prefer.

Capabilities

If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.

ID_CAP_IDENTITY_USER

Windows Phone 8, Windows Phone OS 7.1

For more info, see App capabilities and hardware requirements for Windows Phone 8.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

UserExtendedProperties Class

Microsoft.Phone.Info Namespace