# TypedValue

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.TypedValue/

A value with its data type: the value of a property, or a value in a search condition.

Set `type` and the member of `data` that belongs to it, for example `DATATYPE_TEXT` with
`data.text`, `DATATYPE_MULTI_LINE_TEXT` with `data.multi_line_text`, or `DATATYPE_LOOKUP` with
`data.lookup`. An empty value comes back with `is_null_value` true and `data` unset.

- **Full name:** `MFiles.TypedValue`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-is_null_value"></a>`is_null_value` | `bool` | 2 | True if the value is empty. `data` is then unset. |
| <a id="f-type"></a>`type` | [`Datatype`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.Datatype/index.md) | 1 | The data type of the value. |
| <a id="f-data"></a>`data` | [`TypedValueUnion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.TypedValueUnion/index.md) | 3 | The value, in the member that matches `type`. Unset for an empty value. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCFolderUISettings.SetFolderSelection](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCFolderUISettings/SetFolderSelection/index.md): Replaces the calling user's folder selection for one view level: the folders that the user always wants to see on a level whose listing is cut by the folder limit.
- [IRPCObjectOperations.GetMultipleWorkflowStatesAndTransitions](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetMultipleWorkflowStatesAndTransitions/index.md): Gets the states and transitions of several workflows in one call, in a compressed binary form.
- [IRPCObjectOperations.GetWorkflowStates](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetWorkflowStates/index.md): Gets the states of the given workflow in the appropriate order.
- [IRPCObjectOperations.GetWorkflowStatesAndTransitions](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetWorkflowStatesAndTransitions/index.md): Gets the states and transitions of the given workflow.
- [IRPCPropertyDefsAdmin.AddPropertyDef](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCPropertyDefsAdmin/AddPropertyDef/index.md): Creates a property definition.
- [IRPCPropertyDefsAdmin.GetLastUsedValue](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCPropertyDefsAdmin/GetLastUsedValue/index.md): Gets the last number used by an automatic numbering property.
- [IRPCPropertyDefsAdmin.UpdatePropertyDef](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCPropertyDefsAdmin/UpdatePropertyDef/index.md): Saves a changed property definition.
- [IRPCSearch.GetFolderContents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSearch/GetFolderContents/index.md): Lists the contents of a view or a view level: subviews, grouping folders and objects.

<a id="used-by-messages"></a>

## Used by messages

- [`DefaultPropertyUnion.FixedValueData`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.DefaultPropertyUnion/index.md#t-FixedValueData)
- [`EventTypeSpecificDataUnion.ObjectChangedData`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.EventTypeSpecificDataUnion/index.md#t-ObjectChangedData)
- [`FolderInfoUnion.PropertyFolderData`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.FolderInfoUnion/index.md#t-PropertyFolderData): Property (virtual) folder type.
- [`HistoricalTypedValue`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.HistoricalTypedValue/index.md): Historical typed value represents a typed value at a certain moment.
- [`NamedValue`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.NamedValue/index.md): Struct for a named value stored in a vault.
- [`OCRBlockResult`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.OCRBlockResult/index.md): Struct for describing the OCR result for an OCR block.
- [`ObjectVersionPropertyActivity`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ObjectVersionPropertyActivity/index.md): Object version property activity.
- [`PropertyDef`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyDef/index.md): A property definition: a property that objects can have, with its data type and, for lookup properties, the value list or object type its values come from.
- [`PropertyFolderWithParent`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyFolderWithParent/index.md): Struct for property folder with parent location information.
- [`PropertyFoldersOrDelta`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyFoldersOrDelta/index.md): Struct for property folders or delta (changes to property folders).
- [`PropertyValue`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyValue/index.md): The value of one property: a property definition ID and a typed value.
- [`PropertyValueSuggestion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyValueSuggestion/index.md): The definition of an automatic value.
- [`SearchCondition`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.SearchCondition/index.md): A structure that specifies a single search condition.
- [`ViewLevelFolderSearchResult`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewLevelFolderSearchResult/index.md): One folder that SearchViewLevelFolders found.
- [`ViewLocation`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewLocation/index.md): Struct for a view location.