Sandbox.Reflection

If set on a type, it (and its descendants) can be created and manipulated via the TypeLibrary system, and therefore also in action graphs. Note that this is only useful for our internal libraries because everything in compiled (addons) assemblies is accessible anyway.

Collects all the relevant info (such as description, name, icon, etc) from attributes and other sources about a type or type member.

"Internal" class name of this type or member. This typically should be all lowercase and without weird symbols or whitespace.

Namespace of this type

Namespace.ParentClass.Class.Member

The name of this type or member.

The summary or description of this type or member.

Group or category of this type or member. ()

This is marked as ReadOnly

Material icon of this type or member. ()

Order of this member for UI ordering purposes. ()

Whether this member should be visible in a properties sheet ()

Placeholder text for string type properties. () Placeholder text is displayed in UI when input text field is empty.

Possible aliases for this type or member, if any. ()

Tags of this type or member. ()

Returns whether this type or member has given tag. ()

The tag to test. Whether the tag is present or not

Retrieves display info about a given type.

The type to look up display info for. Whether to load in base type's display info first, then overrides all possible fields with given type's information. The display info. Will contain empty fields on failure.

Retrieves display info about a given objects type.

Retrieves display info about a given member or type.

The member to look up display info for. If member given is a , loads in base type's display info first, then overrides all possible fields with given type's information. The display info. Will contain empty fields on failure.

Returns display info for each member of an enumeration type.

Pattern:
^I[A-Z]
Explanation:


            ○ Match if at the beginning of the string.

            ○ Match 'I'.

            ○ Match a character in the set [A-Z].

Pattern:
^On[A-Z]
Explanation:


            ○ Match if at the beginning of the string.

            ○ Match the string "On".

            ○ Match a character in the set [A-Z].

The assembly might have a pdb embedded inside. So load it with PEReader and have a look inside to see if it is in there. Then if it is, load the assembly with the pdb. I don't know why this isn't done by default.. but apparently it's not. So we have to do it manually.

Try to get the event for which this member is a backing field.

Looks through the inheritance hierarchy of , including its implemented interfaces, for constructed instances of .

Interface for a control sheet that manages the display of serialized properties in a structured way.

Adds properties to the control sheet, filtering them based on the provided filter function.

Add properties to a controlsheet, with a minimal of filtering and no sorting.

Remove methods that we have no hope of displaying

We're adding a feature. Normally would store these in a tab control

We're adding a group. Normally would have a Group Panel with the properties as children

Implement to filter properties that should be displayed in the control sheet.

A feature is usually displayed as a tab, to break things up in the inspector. They can sometimes be turned on and off.

The name of the feature, usually displayed as a tab title in the inspector.

The description of the feature

The icon of the feature

Allows tinting this feature, for some reason

The properties that are part of this feature, usually displayed together in the inspector.

If we have a FeatureEnabled property, this will be it. If not then we assume it should always be enabled.

A group is a collection of properties that are related to each other, and can be displayed together in the inspector, usually with a title.

The name of the group, usually displayed as a title in the inspector.

The properties that are part of this group, usually displayed together in the inspector.

Get all attributes of this type

Get all attributes of this type. Returns the type description along with the attribute. This will also return types that inherit the attribute from base classes too.

Get all attributes of this type. Returns the type description along with the attribute. If inherited is false, we will return only classes that contain this attribute directly.

Get single attribute of type, from type

Get all attribute of type, from all types assignable to type

Get or cache the result

Clear the cache. Should be called when types are added or removed.

Will throw an exception if the type isn't in the whitelist

We're allowed to use the type if we know about it

Create a type instance by name and is assignable to given type, with optional arguments for its constructor.

Name of the type to create. Type "constraint", as in the type instance must be assignable to this given type. Optional arguments for the constructor of the selected type.

Create type instance from type.

Create a type instance by name and is assignable to given type.

Name of the type to create. Display a warning when requested type name was not found. Type "constraint", as in the type instance must be assignable to this given type.

Create a type instance by name and is assignable to given type.

Name of the type to create. Display a warning when requested type name was not found. Type "constraint", as in the type instance must be assignable to this given type.

Create a type instance by its identity. See .

Create type by type

If set, will be used to determine whether a private member should be exposed.

Find all methods with given attribute, optionally non static

Find all static methods with given name.

Find all static methods with given name and given attribute.

Find all member attributes (instances) with given attribute type.

Find all static members with given attribute.

Find all static or non static only member attributes (instances) with given attribute type.

Get a list of properties on the target object. To do this we'll just call GetDescription( obj.GetType() ) and return .Properties. Will return an empty array if we can't access these properties.

Set a named property on given object. Will perform extra magic for string inputs and try to convert to target property type.

The target object to set a named property on. Name of the property to set. Value for the property. Whether the property was set or not.

Try to get a value from a property on an object

Serialize this value to bytes, where possible

Deserialize this from bytes. If the type is unknown, T can be an object.

The editor's TypeLibrary contains the game's typelibrary as well as all the editor types. This is null when not running in editor mode!

Called to populate StringTokens with our custom tokens in c#

The current TypeLibrary. God we could make TypeLibrary a big sexy static class how awesome would that be.

A list of loaded types.

Clean up after ourselves

Add essential types from System assemblies, for example , , and . Only public members of these types will be added.

Add an assembly yo the library. If marked as dynamic then all types are added.

For some system types we only want to expose a subset of public members. In the future we should try to use the same whitelist as when checking user code, but that's a bit scary.

Find a type that was previously removed

Store this type in the removed list, incase the assembly comes back. We can re-initialize it - so all the references to it will be unchanged.

Removed all of the stored removed types

Remove a specific assembly and all types associated with it

Get hash of a type.

Get the description for a specific type. This will return null if you don't have whitelist access to the type. For constructed generic types, this will give you the description of the generic type definition.

Convert a list of to a list of integers representing their TypeLibrary identity.

Convert a list of integers representing their TypeLibrary identity to a list of

Get a list of types that implement this generic type

Get descriptions for all types that derive from T

Find a TypeDescription that derives from , by name

Find a TypeDescription that derives from T by name, which can be an Alias etc. If preferAddonAssembly is true, then if there are conflicts we'll prefer types that are in addon code.

Find a TypeDescription that derives from T by name, which can be an Alias etc. If preferAddonAssembly is true, then if there are conflicts we'll prefer types that are in addon code. If exactFullName is true, the name must match the FullName of the type.

Find a TypeDescription that derives from T by name, which can be an Alias etc. If preferAddonAssembly is true, then if there are conflicts we'll prefer types that are in addon code.

The base type to search for, or null to search all types The name to search for, which can be an alias or the full name depending on the value of If true, then if there are conflicts we'll prefer types that are in addon code. If true, the name must match the FullName (or alias) of the type

Get descriptions for all types that derive from T

Get all types

Find the description for templated type

Find the description type

Find a TypeDescription by name

Find a by its

Find a TypeDescription that derives from , by name

Performs with access control checks. Will throw if any arguments aren't in the whitelist.

Constructed generic type to get the arguments of

Return true if this type contains this attribute

Check if all properties of this class instance pass their .

Object to test. True if all properties pass their validity checks (or if there are no checks), false otherwise.

Check if all properties of this class instance pass their .

Object to test. string array of first invalid obj property error True if all properties pass their validity checks (or if there are no checks), false otherwise.

Get a SerializedObject version of this object

Gets a SerializedObject version of a value retrieved from a function.

Get a SerializedObject version of this type of object, but data is stored in a dictionary

Get a class describing the values of an enum

Create a serialized property that uses a getter and setter

Create a serialized property from a SerializedObject

This is used primarily to get GlobalRpcHandler.OnRpc

This is a hash of loaded assembly names. We can use it to make sure we're using the same code as the server. This is important when it comes to things like decoding network messages and datatables - because if the code is different we're going to get errors, because it could expect different data.

This isolates the dll so it can be unloaded and can have the same name as other loaded dlls

If the assembly isn't found in this context, we'll load from the context used by the root Assembly.

An implementation of TypeLibrary which uses TypeLibrary to fill out properties

An implementation of SerializedObject which uses TypeLibrary to fill out properties

If the object is a value type, we call a method to get the value each time before we change/update/read it. If it's a class, we fetch it once and set FetchTarget to null.

Get the target object. If the target object is a value type, we'll call FetchTarget() - which should fetch the latest copy of it from the parent. Note that by design FetchTarget is null if it's not a value type.

When setting because a child property changed, we don't trigger NoteChanged because the expectation is that the NoteChanged from setting that property will instead propogate up, and will be more accurate.

A packer that handles serialization and deserialization for implementations of .

Write an object to the through the implementation of for this type.

Read an object from the through the implementation of for this type.

Describes a field. We use this class to wrap and return FieldInfo's that are safe to interact with. Returned by and .

Property type.

Get the value of this property on given object.

Set the value of this property on given object.

When applied to an attribute, which is them applied to a member.. This will make set on the attribute upon load. This provides a convenient way to know which member the attribute was attached to.

Description of the member this attribute was attached to.

Wraps MemberInfo but with caching and sandboxing. Returned by and .

The type that we're a member of

The type that actually defined this member. This may be different from if this member is inherited from a base class.

Unique identifier based on full name

Name of this type member.

An integer that represents this member. Based off its type and name.

Display name or title of this type member.

Description of this type member. This usually provided from the summary XML comment above the definition.

The icon for this, if provided via the [Icon] attribute

The group - usually provided via the [Group] attribute

If this is marked as [ReadOnly]

The display order - usually provided via the [Order] attribute

Tags are usually provided via the [Tags] attribute

Aliases allow this to be found by alternative names.

Attributes on this member

Access the full DisplayInfo for this type. This is faster than creating the DisplayInfo every time we need it.

True if static

True if publicly accessible

True if we're a method

True if we're a property

True if we're a field

The line number of this member

The file containing this member

Generate a unique hash to identity this member.

Utility function to check whether this string matches this type. Will search name and classname.

Returns true if Tags contains this tag

TODO - create MethodDescription?

Whether or not this has at least one of the specified attribute.

Returns the first of Attributes of the passed in type. Or null.

Describes a method. We use this class to wrap and return MethodInfo's that are safe to interact with. Returned by and .

Returns true - because this is a method

Gets the return type of this method.

Gets a list of parameters expected by this method

Invokes this method.

Should be null if this is static, otherwise should be the object this is a member of. An array of parameters to pass. Should be the same length as Parameters

Invokes this method and returns a value.

Should be null if this is static, otherwise should be the object this is a member of. An array of parameters to pass. Should be the same length as Parameters

Creates a delegate bound to this method.

Delegate type

Creates a delegate bound to this method.

Delegate type Value for the first parameter / target object

Creates a delegate bound to this method.

Delegate type to create

Creates a delegate bound to this method.

Delegate type to create Value for the first parameter / target object

Describes a property. We use this class to wrap and return PropertyInfo's that are safe to interact with. Returned by and .

Whether this property can be written to.

Whether this property can be read.

Whether the getter of this property is public.

Whether the setter of this property is public.

Whether the setter of this property is init only.

Property type.

True if this property has index parameters

Get the value of this property on given object.

Set the value of this property on given object.

Gets all component types referenced using "scene.get" nodes. These components are expected to be on the GameObject containing the graph.

All action graph reflection goes through here, so we can control what people can access.

Used when an action graph serializes a . Must match .

Used when an action graph deserializes a . Must match .

Describes a type. We use this class to wrap and return System.Type's that are safe to interact with. Returned by .

The type this class describes.

The base type. This can return null if the type isn't in the type library!

Whether the class is valid or not, i.e. whether the type still exists.

Is from an assembly that was whitelist tested, so it can't have any bad stuff in it. We can feel happy to expose all members in these assemblies.

Attributes that we, and our bases, implement

Attributes that we implement directly

All members (methods, properties, etc) of this type.

Members (methods, properties, etc) declared by exactly this type, and not inherited.

All methods of this type.

All properties of this type.

All fields on this type.

True if the target type is an interface

True if the target type is an enum

True if the target type is static

True if the target type is a class

True if the target type is a value

Gets a value indicating whether the System.Type is abstract and must be overridden.

Name of this type.

Namespace of this type.

Full name of this type.

Preferred name to use when serializing this type.

Tags are set via the [Tag] attribute

An integer that represents this type. Based off the class name.

A string representing this class name. Historically this was provided by [Library( classname )]. If no special name is provided, this will be type.Name.

The line number of this member

The file containing this member

This needs to generate a unique string per member on a type.

Returns true if this is named the passed name, either through classname, target class name or an alias

The name to check If true, only the exact full name or aliases will match.

Returns the first attribute of given type, if any are present.

Returns all attributes of given type, if any are present.

Returns true if the class has this attribute

True if we have this tag.

Get property by name (will not find static properties)

Get static property by name

Get field by name (will not find static fields)

Get value by field or property name (will not find static members)

Get value by field or property name, and which type the member is declared to store (will not find static members)

Get value by field or property name, and which type the member is declared to store

Set value by field or property name (will not set static members)

Set static value by field or property name

Get a method by name (will not find static methods)

True if we're a generic type

If we're a generic type this will return our generic parameters.

If we implement any interfaces they will be here

Create an instance of this class, return it as a T. If it can't be cast to a T we won't create it and will return null.

Create an instance of this class using generic arguments We're going to assume you know what you're doing here and let it throw any exceptions it wants.

For generic type definitions, create a type by substituting the given types for each type parameter. Returns null if any of the type arguments violate the generic constraints.

Finds all static fields assignable to across all types in the given assembly and sets them to null. Useful for releasing references during teardown.

If is a collection containing elements assignable to , remove those elements (or clear the whole collection). Returns true if any work was done.

Nulls a static readonly (initonly) field by emitting a DynamicMethod that uses stsfld directly, bypassing the CLR verifier check that normal reflection enforces on initonly fields.

Returns true if the type itself or any of its implemented generic interfaces (IEnumerable<T>, IDictionary<K,V>, etc.) has a generic argument assignable to . This covers types like HashSetEx<T> that don't implement standard collection interfaces directly.

Pre-compile all of the methods that we can, to reduce the risk of them compiling during gameplay

Custom -derived type for the InterfaceTypeNameRegex method.

Cached, thread-safe singleton instance.

Initializes the instance.

Provides a factory for creating instances to be used by methods on .

Creates an instance of a used by methods on .

Provides the runner that contains the custom logic implementing the specified regular expression.

Scan the starting from base.runtextstart for the next match.

The text being scanned by the regular expression.

Search starting from base.runtextpos for the next location a match could possibly start.

The text being scanned by the regular expression. true if a possible match was found; false if no more matches are possible.

Determine whether at base.runtextpos is a match for the regular expression.

The text being scanned by the regular expression. true if the regular expression matches at the current position; otherwise, false.

Custom -derived type for the EventMethodNameRegex method.

Cached, thread-safe singleton instance.

Initializes the instance.

Provides a factory for creating instances to be used by methods on .

Creates an instance of a used by methods on .

Provides the runner that contains the custom logic implementing the specified regular expression.

Scan the starting from base.runtextstart for the next match.

The text being scanned by the regular expression.

Search starting from base.runtextpos for the next location a match could possibly start.

The text being scanned by the regular expression. true if a possible match was found; false if no more matches are possible.

Determine whether at base.runtextpos is a match for the regular expression.

The text being scanned by the regular expression. true if the regular expression matches at the current position; otherwise, false.

Helper methods used by generated -derived implementations.

Default timeout value set in , or if none was set.

Whether is non-infinite.