LeaderboardEntry.Columns Property
Provides access to the columns of key/value data associated with this leaderboard entry.
Namespace: Microsoft.Xna.Framework.GamerServices
Assembly: Microsoft.Xna.Framework.GamerServices (in microsoft.xna.framework.gamerservices.dll)
Syntax
public PropertyDictionary Columns { get; }
Property Value
A PropertyDictionary containing columns information for this leaderboard entry.
Remarks
Each leaderboard entry contains a set of fixed data columns that can be accessed using string keys. Not all columns can be written to, and depending on the type of leaderboard (score or time), only some of the columns will set or retrieve valid data.
The columns accessible for an individual leaderboard entry are:
| Column | Value type | Read/Write? | Description |
|---|---|---|---|
| Outcome | LeaderboardOutcome | R/W | Represents the outcome (score or time) of this leaderboard entry. If this leaderboard is configured as a BestScore leaderboard, this column will contain a long value representing the score for this entry. |
| Blob | Stream | R/W | This is arbitrary blob data that is associated with the leaderboard. It can represent any game-dependent data associated with this leaderboard entry, but is limited to 10KB in size. |
| TimeStamp | DateTime | R/W | The time that this leaderboard entry was recorded. |
| BestScore | Int64 | R | The best score data associated with this leaderboard entry. It is only valid for BestScore leaderboards. This is a read-only column. It is set with the Rating member of the LeaderboardEntry structure. |
| BestTime | DateTime | R | The best time data associated with this leaderboard entry. It is only valid for BestTime leaderboards. This is a read-only column. It is set with the Rating member of the LeaderboardEntry structure. |
| CumulativeScore | Int64 | R | Contains the cumulative score for the player. It is only valid for BestScore leaderboards. This is a read-only column, and the value is calculated by Xbox LIVE. |
| CumulativeTime | DateTime | R | Contains the cumulative time for the player. It is only valid for BestTime leaderboards. This is a read-only column, and the value is calculated by Xbox LIVE. |
| GamesPlayed | Int64 | R | Contains the number of games played by the player. This is a read-only column, and the value is calculated by Xbox LIVE. |
| AverageScore | Int64 | R | Contains the average score for the player. It is only valid for BestScore leaderboards. This is a read-only column, and the value is calculated by Xbox LIVE. |
| AverageTime | DateTime | R | Contains the average time for the player. It is only valid for BestTime leaderboards. This is a read-only column, and the value is calculated by Xbox LIVE. |
| Wins | Int64 | R | Contains the number of wins for the player, as determined by the Outcome column. This is a read-only column, and the value is calculated by Xbox LIVE. |
| Losses | Int64 | R | Contains the number of losses for the player, as determined by the Outcome column. This is a read-only column, and the value is calculated by Xbox LIVE. |
| LastPlayedDate | DateTime | R | Contains the last time the gamer associated with this leaderboard played the game. This is a read-only column, and the value is calculated by Xbox LIVE. |
Warning
This property retrieves a calculated result only for titles approved to access Xbox LIVE services through the Xbox LIVE Registered Developer Program. For Xbox LIVE Indie games, this property will return immediately with a predetermined default value.
See Also
Tasks
Reference
LeaderboardEntry Class
LeaderboardEntry Members
Microsoft.Xna.Framework.GamerServices Namespace
Platforms
Xbox 360, Windows 7, Windows Vista, Windows XP