VisualizerDevelopmentHost Class

Definition

Namespace:

Microsoft.VisualStudio.DebuggerVisualizers

Assembly:

Microsoft.VisualStudio.DebuggerVisualizers.dll

Package:

Microsoft.VisualStudio.DebuggerVisualizers v17.6.1032901

Host class for testing during development of the Managed custom visualizer.

public ref class VisualizerDevelopmentHost

[Windows::Foundation::Metadata::WebHostHidden]
class VisualizerDevelopmentHost

public class VisualizerDevelopmentHost

type VisualizerDevelopmentHost = class

Public Class VisualizerDevelopmentHost

Inheritance

Object

VisualizerDevelopmentHost

Examples

The following example code creates a visualizer development host and calls the host to show the visualizer. MyDataObject is the data object you want to show in the visualizer. MyVisualizer is the visualizer itself.

public static void TestShowVisualizer(object MyDataObject)
{
    VisualizerDevelopmentHost visualizerHost = new VisualizerDevelopmentHost(MyDataObject, typeof(MyVisualizer);
    visualizerHost.ShowVisualizer();
} 

The calling code looks as follows:

String myString = "Hello, World!";  // Create an object to visualize  
Visualizer1.TestShowVisualizer(myString);  // Call the host to visualize it  

Remarks

You can use this class to create a harness for testing and debugging a debugger visualizer. Custom Visualizers are small custom applications called from the Visual Studio debugger to display data objects in a manner appropriate to their data type. This class enables you to run a visualizer for testing and debugging purposes without installing the visualizer into Visual Studio. Using the harness makes debugging a visualizer much easier.

Constructors

VisualizerDevelopmentHost(Object, Type, Type, Boolean)	Constructor to create a visualizer development hostby using a data object that you want to test the visualizer on and a type that identifies the visualizer class.
VisualizerDevelopmentHost(Object, Type, Type)	Constructor to create a visualizer development hostby using a data object that you want to test the visualizer on and a type that identifies the visualizer class.
VisualizerDevelopmentHost(Object, Type)	Constructor to create a visualizer development hostby using a data object that you want to test the visualizer on and a type that identifies the visualizer class.

Methods

ShowVisualizer()	Calls the visualizer development host to show the visualizer, without parameters.
ShowVisualizer(Control)	Calls the visualizer development host to show the visualizer, passing a control that you want the visualizer parented to.
ShowVisualizer(IWin32Window)	Calls the visualizer development host to show the visualizer, passing a window that you want the visualizer parented to.