Skip to content
Cannot retrieve contributors at this time
64 lines (39 sloc) 3.91 KB

When Set... Break

Do you ever scratch your head while debugging, asking yourself "Where did the value of this property come from?". Next time, just create a Setter Point! When the property value is changed, OzCode will break into the debugger, allowing you to inspect the state of the program and figure exactly why that problematic value got there in the first place!


The toughest bugs to figure out are those that involve mutating state. What do you do if at some point during the program’s execution, the state of some objects becomes invalid, but you have no idea exactly when and how they got that way? While inspecting values in the debugger, when you spot a problematic property value, use the Magic Wand and choose “When Set -> Break”. The next time the property value is changed, OzCode will break into the debugger and allow you to inspect the state of the program, and figure exactly how that problematic value got there in the first place! These Setter Breakpoints work on both regular properties and auto-properties, and you can even add a Setter Breakpoint on properties you don’t have the source code to!

Using When Set... Break

In order to run this demo click the When Set... Break button in the demo application.

When Break.. Set button button

After the run has finished, a log message will show. Going over the log messages, you can notice a problem: it seems that certain customers were mistakenly billed for other people's orders (invoices sent). Ouch!


A quick glance through the code will show that the customer we're going to send the bill to is taken out of the OrderInfo.Customer, which is initialized during the object construction in the begining of ProcessOrder:


Clearly someone has changed the Customer property somewhere (by mistake). That person should be fired! ;) But now we have two choices - we either run the program line by line until we find the offending line (or lines) of code, or use OzCode's When Set feature (hint, hint).

  • To use the feature, we first need to stop after orderInfo was created. Run the demo again until you reach the breakpoint, and hover over the newly created OrderInfo instance.
  • Now expand the OrderInfo object's properties, and hover over Customer
  • Move your pointer over the Magic Wand that appears
  • Choose Break from the When Set menu

Choosing When Set

The following dialog will appear:

Break When Set dialog

Since we want to break on any OrderInfo instance, leave the first radio button checked.
The problem is that we don't want to break on the initial object creation (where Customer property is also set), so in-order to refine the breakpoint, add the following condition:

this.Customer != null 

When setting the condition two special keywords can be used:

  • value: the new value that is about to be set
  • this: the object which contains the property that is about to be set

Note: Using this and value in the condition simple and easy since there is full IntelliSense support!

And so false positives are eliminated by removing the cases in which the value is just being initialized:

Break When Set - Final

Click 'OK' to set the new breakpoint, and then hit F5.

Don't forget to remove the "regular" breakpoint so that the execution won't stop on every single iteration.

Once the new breakpoint is triggered we can use Reveal to see the new data: Just move the mouse pointer over the new value and "star" the information you want to see.

Use reveal on set

Find the root cause of the bug by going back to the calling method (OrderProcessing.ShipOrder), using the StackTrace:

Root cause

Back to Main

You can’t perform that action at this time.