ExpressionContext Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Provides a means of passing context state among serializers. This class cannot be inherited.

Namespace:   System.ComponentModel.Design.Serialization
Assembly:  System.Design (in System.Design.dll)


public sealed class ExpressionContext

System_CAPS_pubmethodExpressionContext(CodeExpression, Type, Object)

Initializes a new instance of the ExpressionContext class with the given expression and owner.

System_CAPS_pubmethodExpressionContext(CodeExpression, Type, Object, Object)

Initializes a new instance of the ExpressionContext class with a current value.


Gets the expression this context represents.


Gets the Type of the expression.


Gets the object owning this expression.


Gets the preset value of an expression.


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Returns a string that represents the current object.(Inherited from Object.)

An ExpressionContext is placed on the context stack and contains the most relevant expression during serialization. The following C# code demonstrates an assignment.

button1.Text = "Hello";

During serialization, several serializers are responsible for creating this single statement. One of those serializers is responsible for creating "Hello". There are times when that serializer may need to know the context in which it is creating its expression. In the previous example, this context is not needed. The following C# code shows a situation in which knowledge of the context is necessary.

button1.Text = rm.GetString("button1_Text");

In this case, the serializer responsible for creating the resource expression needs to be informed of the names of the target objects. The ExpressionContext class can be used for this. As each serializer creates an expression and invokes a serializer to handle a smaller part of the statement as a whole, the serializer pushes an expression context on the context stack. Each expression context has a parent property that locates the next expression context on the stack. This provides a convenient traversal capability.

.NET Framework
Available since 2.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top