Keith Newton

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




Re: XNA Framework Some missing documentation?

CodePfo

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).




Re: XNA Framework Some missing documentation?

Shawn Hargreaves - MSFT

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.





Re: XNA Framework Some missing documentation?

Keith Newton

Thanks guys, much appreciated.