# SelectHyperCubeValuesAsync Method

## Overloads

| [SelectHyperCubeValuesAsync(String, Int32, IEnumerable<Int32>, Boolean)](https://help.qlik.com/en-US/sense-developer/November2024/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm#Qlik_Engine_IGenericObject_SelectHyperCubeValuesAsync_System_String_System_Int32_System_Collections_Generic_IEnumerable_System_Int32__System_Boolean_) |  | Selects some values in one dimension.<br><br>The values are identified by their element numbers.<br><br>The member **Change** returns the handles of the objects that are updated following the selections.<br><br><br>`qSuccess` is set to `true` if the selections are successful and is set to `false` in the following cases:<br><br>\* The object contains some invalid fields (fields that are not in the data model).<br><br>\* The selection applies to a locked field.<br><br>\* A range selection is performed and the parameter `OneAndOnlyOne` is set to true in the definition of the object. |
| --- | --- | --- |
| [SelectHyperCubeValuesAsync(AsyncHandle, String, Int32, IEnumerable<Int32>, Boolean)](https://help.qlik.com/en-US/sense-developer/November2024/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm#Qlik_Engine_IGenericObject_SelectHyperCubeValuesAsync_Qlik_Engine_AsyncHandle_System_String_System_Int32_System_Collections_Generic_IEnumerable_System_Int32__System_Boolean_) |  | Selects some values in one dimension.<br><br>The values are identified by their element numbers.<br><br>The member **Change** returns the handles of the objects that are updated following the selections.<br><br><br>`qSuccess` is set to `true` if the selections are successful and is set to `false` in the following cases:<br><br>\* The object contains some invalid fields (fields that are not in the data model).<br><br>\* The selection applies to a locked field.<br><br>\* A range selection is performed and the parameter `OneAndOnlyOne` is set to true in the definition of the object. |
| [SelectHyperCubeValuesAsync<T>(AsyncHandle, Func<Response, T>, String, Int32, IEnumerable<Int32>, Boolean)](https://help.qlik.com/en-US/sense-developer/November2024/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm#Qlik_Engine_IGenericObject_SelectHyperCubeValuesAsync__1_Qlik_Engine_AsyncHandle_System_Func_Qlik_Engine_Communication_IO_Response___0__System_String_System_Int32_System_Collections_Generic_IEnumerable_System_Int32__System_Boolean_) |  | Selects some values in one dimension.<br><br>The values are identified by their element numbers.<br><br>The member **Change** returns the handles of the objects that are updated following the selections.<br><br><br>`qSuccess` is set to `true` if the selections are successful and is set to `false` in the following cases:<br><br>\* The object contains some invalid fields (fields that are not in the data model).<br><br>\* The selection applies to a locked field.<br><br>\* A range selection is performed and the parameter `OneAndOnlyOne` is set to true in the definition of the object. |

[](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm) [](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm)

## SelectHyperCubeValuesAsync(String, Int32, IEnumerable&lt;Int32&gt;, Boolean)

Selects some values in one dimension.

The values are identified by their element numbers.

The member **Change** returns the handles of the objects that are updated following the selections.

`qSuccess` is set to `true` if the selections are successful and is set to `false` in the following cases:

* The object contains some invalid fields (fields that are not in the data model).
* The selection applies to a locked field.
* A range selection is performed and the parameter OneAndOnlyOne is set to true in the definition of the object.

### Declaration

```

          Task<bool> SelectHyperCubeValuesAsync([QixName("qPath")] string path, [QixName("qDimNo")] int dimNo, [QixName("qValues")] IEnumerable<int> values, [QixName("qToggleMode")] bool toggleMode)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| System.String | path | Path to the definition of the object to be selected.<br>For example, `/qHyperCubeDef` . |
| System.Int32 | dimNo | Dimension number or index to select.<br>Dimension numbers/index start from 0. |
| System.Collections.Generic.IEnumerable&lt;System.Int32&gt; | values | Element numbers of the field to select.<br>You can select multiple elements; the separator is the comma. |
| System.Boolean | toggleMode | Set to true to toggle. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task&lt;System.Boolean&gt; |  |

### Remarks

This method applies to charts, tables and scatter plots.

[](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm) [](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm)

## SelectHyperCubeValuesAsync(AsyncHandle, String, Int32, IEnumerable&lt;Int32&gt;, Boolean)

Selects some values in one dimension.

The values are identified by their element numbers.

The member **Change** returns the handles of the objects that are updated following the selections.

`qSuccess` is set to `true` if the selections are successful and is set to `false` in the following cases:

* The object contains some invalid fields (fields that are not in the data model).
* The selection applies to a locked field.
* A range selection is performed and the parameter OneAndOnlyOne is set to true in the definition of the object.

### Declaration

```

          Task<bool> SelectHyperCubeValuesAsync(AsyncHandle asyncHandle, [QixName("qPath")] string path, [QixName("qDimNo")] int dimNo, [QixName("qValues")] IEnumerable<int> values, [QixName("qToggleMode")] bool toggleMode)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/November2024/Subsystems/NetSDKAPIref/Content/Qlik.Engine.AsyncHandle.htm) | asyncHandle | Handle to asynchronous method request |
| System.String | path | Path to the definition of the object to be selected.<br>For example, `/qHyperCubeDef` . |
| System.Int32 | dimNo | Dimension number or index to select.<br>Dimension numbers/index start from 0. |
| System.Collections.Generic.IEnumerable&lt;System.Int32&gt; | values | Element numbers of the field to select.<br>You can select multiple elements; the separator is the comma. |
| System.Boolean | toggleMode | Set to true to toggle. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task&lt;System.Boolean&gt; |  |

### Remarks

This method applies to charts, tables and scatter plots.

[](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm) [](https://help.qlik.com/en-US/sense-developer/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IGenericObject.SelectHyperCubeValuesAsync.htm)

## SelectHyperCubeValuesAsync&lt;T&gt;(AsyncHandle, Func&lt;Response, T&gt;, String, Int32, IEnumerable&lt;Int32&gt;, Boolean)

Selects some values in one dimension.

The values are identified by their element numbers.

The member **Change** returns the handles of the objects that are updated following the selections.

`qSuccess` is set to `true` if the selections are successful and is set to `false` in the following cases:

* The object contains some invalid fields (fields that are not in the data model).
* The selection applies to a locked field.
* A range selection is performed and the parameter OneAndOnlyOne is set to true in the definition of the object.

### Declaration

```
Task<T> SelectHyperCubeValuesAsync<T>(AsyncHandle asyncHandle, Func<Response, T> onResult, [QixName("qPath")] string path, [QixName("qDimNo")] int dimNo, [QixName("qValues")] IEnumerable<int> values, [QixName("qToggleMode")] bool toggleMode)
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/November2024/Subsystems/NetSDKAPIref/Content/Qlik.Engine.AsyncHandle.htm) | asyncHandle | Handle to asynchronous method request |
| System.Func&lt;[Response](https://help.qlik.com/en-US/sense-developer/November2024/Subsystems/NetSDKAPIref/Content/Qlik.Engine.Communication.IO.Response.htm), T&gt; | onResult | Continuation function |
| System.String | path | Path to the definition of the object to be selected.<br>For example, `/qHyperCubeDef` . |
| System.Int32 | dimNo | Dimension number or index to select.<br>Dimension numbers/index start from 0. |
| System.Collections.Generic.IEnumerable&lt;System.Int32&gt; | values | Element numbers of the field to select.<br>You can select multiple elements; the separator is the comma. |
| System.Boolean | toggleMode | Set to true to toggle. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task&lt;T&gt; |  |

### Type Parameters

| Name | Description |
| --- | --- |
| T |  |

### Remarks

This method applies to charts, tables and scatter plots.