Some missing documentation?

Hello, I was working on my content pipeline classes and in my ContentTypeReader<T>.Read() existingInstance is being passed in as null (so much for existing!). I thought that was a bit curious so I decided to look it up in the docs. To my great surprise Read() is not listed as a method for class ContentTypeReader<T> though I am clearly overriding it and in the content pipeline example documentation it is clearly being overridden. I had a few other people see if it appeared in their local documentation and the online documentation - they also said it doesn't exist. I am just wondering if this is possibly a bug in the documentation?

class ContentTypeReader<T>:

ms-help://MS.VSExpressCC.v80/MS.VSIPCC.v80/MS.XNAFX.1033/XNA/ContentTypeReader`1_Content_Framework_Xna_Microsoft_T_AllMembers.htm

[839 byte] By [KeithNewton] at [2007-12-27]
# 1
That does seem a little odd :) Anyway, if you use reflector and look at existing ContentTypeReader implementations in the pipeline, they ignore the existingInstance parameter and just return a new instance (at least all the ones I checked out).
CodePfo at 2007-9-3 > top of Msdn Tech,Game Technologies: DirectX, XNA, XACT, etc.,XNA Framework...
# 2
The existingInstance parameter isn't used in any of the current reader implementations.

This is intended for some possible future scenarios where we might want

to do smarter more automatic serialization, in which case it is needed

to handle serializing elements into collections that are exposed as

read-only properties.

Not sure if we will ever do that, but we wanted to make sure the

parameter was there in the API ready for that possible expansion if we

ever turned out to need it.

For now you can totally ignore this.

ShawnHargreaves-MSFT at 2007-9-3 > top of Msdn Tech,Game Technologies: DirectX, XNA, XACT, etc.,XNA Framework...
# 3
Thanks guys, much appreciated.
KeithNewton at 2007-9-3 > top of Msdn Tech,Game Technologies: DirectX, XNA, XACT, etc.,XNA Framework...