IVisualizerObjectProvider.ReplaceObject Method

Namespace:  Microsoft.VisualStudio.DebuggerVisualizers
Assembly:  Microsoft.VisualStudio.DebuggerVisualizers (in Microsoft.VisualStudio.DebuggerVisualizers.dll)

Syntax

'Declaration
Sub ReplaceObject ( _
    newObject As Object _
)

void ReplaceObject(
    Object newObject
)

void ReplaceObject(
    Object^ newObject
)

abstract ReplaceObject : 
        newObject:Object -> unit

function ReplaceObject(
    newObject : Object
)

Parameters

• newObject
  Type: System.Object

  The new object to replace the object currently being visualized.

Remarks

Replaces the object being visualized with a new object that you specify. This results in the newObject parameter being serialized and passed to the ReplaceData method.

Examples

public class DebuggerSide : DialogDebuggerVisualizer
{
   override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
   {
      // Get a string from the debuggee side and display it in a message box.
      String myString = objectProvider.GetObject().ToString();
      MessageBox.Show(myString);
      
      // Modify the string and send it back to the debuggee side.
      String myNewString = myString.ToUpper();
      // Make sure the object is replacable before you try to replace it.
      // Otherwise, you will get an exception.
      if (objectProvider.IsObjectReplaceable)
      {
      // This example assumes the object source is expecting a string.
         objectProvider.ReplaceObject(myNewString);
      }
   }
// Other DebuggerSide methods ommitted for clarity.
}

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

IVisualizerObjectProvider Interface

Microsoft.VisualStudio.DebuggerVisualizers Namespace