Home/ Questions/Q 95143
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-10T23:36:43+00:00

I have a function that identify coordinates on a page, and I am returning

  • 0

I have a function that identify coordinates on a page, and I am returning them as a

Dictionary<int, Collection<Rectangle>> GetDocumentCoordinates(int DocumentId)

However, later I need information about each page – if it was validated, what is the page resolution, color/bw, etc. I could create another function and run through pretty much the same result set as the previous function and get that information. 

Dictionary<int, PageInfo> GetDocumentAttributes(int DocumentId)

Another alternative would be to add a ref parameter so I can get these values back.

Dictionary<int, Collection<Rectangle>> GetCoordinates(int DocumentId, ref Dictionary<int, PageInfo> PageAttributes)

Yet another alternative is to create an encompassing class that contains the Dictionary and the page information:

class DocumentInfo {     Dictionary<int, Collection<Rectangle>> Coordinates { get; set;}     Dictionary<int, PageInfo> PageAttributes { get; set; } }

and then define:

DocumentInfo GetDocumentInfo(int DocumentId);

I’m leaning towards the last option, but your insights are very much appreciated.

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. The last option is definitely the best. I’ve found that, when taking or returning complex data with multiple meanings, creating a complex type to encapsulate this data is the best practice for a number of reasons.

    First, your return data probably will change as your design changes. Encapsulating this data in an object allows you to alter what it carries and how your methods operate on this data without altering the interfaces of your objects. Obviously, your data object shouldn’t implement an interface; at most, have a base class with the minimum interface and then pass references to the base around.

    Second, you may find your data gets complex to the point where you will need to perform validation on it. Rather than have this validation in all the methods of your classes where you act upon this data, you can easily wrap this up in the data class. Single responsibility, etc.

    • 0