Gamer.LeaderboardWriter Property

  • Article

Gets an object that can be used to write leaderboard statistics for this gamer.

Namespace: Microsoft.Xna.Framework.GamerServices
Assembly: Microsoft.Xna.Framework.GamerServices (in microsoft.xna.framework.gamerservices.dll)

Syntax

public LeaderboardWriter LeaderboardWriter { get; }

Property Value

A LeaderboardWriter that can be used to write leaderboard statistics for this gamer. Will be null if leaderboards are not available for this gamer.

Remarks

Leaderboards can be written from local, player match, or ranked sessions, using the following rules:

  • Ranked sessions can write to both arbitrated and non-arbitrated leaderboards.
  • Other session types can only write to non-arbitrated leaderboards.
  • Arbitrated statistics should be written by all machines for all gamers.
  • Non-arbitrated statistics should only be written by their local machine.
  • In ranked sessions, all machines should report TrueSkill for all gamers.
  • In other session types, only the host should report TrueSkill data.

Leaderboards can only be written when the session is actually playing the game, not when it is in the lobby state. This property will return null if leaderboards are not available for this gamer, which occurs in system link sessions, or if the gamer profile is a guest or not signed into Xbox LIVE, or if the game is in trial mode.

See Also

Reference

Gamer Class
Gamer Members
Microsoft.Xna.Framework.GamerServices Namespace

Platforms

Xbox 360, Windows 7, Windows Vista, Windows XP