# SelectAsync Method

## Overloads

| [SelectAsync(String, Boolean, Int32)](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.Field.SelectAsync.htm#Qlik_Engine_Field_SelectAsync_System_String_System_Boolean_System_Int32_) |  | Selects field values matching a search string. |
| --- | --- | --- |
| [SelectAsync(AsyncHandle, String, Boolean, Int32)](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.Field.SelectAsync.htm#Qlik_Engine_Field_SelectAsync_Qlik_Engine_AsyncHandle_System_String_System_Boolean_System_Int32_) |  | Selects field values matching a search string. |
| [SelectAsync<T>(AsyncHandle, Func<Response, T>, String, Boolean, Int32)](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.Field.SelectAsync.htm#Qlik_Engine_Field_SelectAsync__1_Qlik_Engine_AsyncHandle_System_Func_Qlik_Engine_Communication_IO_Response___0__System_String_System_Boolean_System_Int32_) |  | Selects field values matching a search string. |

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

## SelectAsync(String, Boolean, Int32)

Selects field values matching a search string.

### Declaration

```

          public Task<bool> SelectAsync([QixName("qMatch")] string match, [QixName("qSoftLock")] bool softLock = false, [QixName("qExcludedValuesMode")] int excludedValuesMode = 0)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| System.String | match | String to search for.<br>Can contain wild cards or numeric search criteria.<br>The characters &lt;&gt;"~()='[] have pre-defined meanings when used at the start of the string.<br>To use them, EnableSpecialCharacterEscapingInSearch needs to be enabled and the delimiter \ needs to precede the special character. |
| System.Boolean | softLock | Set to true to ignore locks; in that case, locked fields can be selected.<br>The default value is false. |
| System.Int32 | excludedValuesMode | Include excluded values in search. |

### Returns

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

### Implements

[IField.SelectAsync(String, Boolean, Int32)](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IField.SelectAsync.htm#Qlik_Engine_IField_SelectAsync_System_String_System_Boolean_System_Int32_)

### Remarks

The operation is successful if qReturn is set to true.

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

## SelectAsync(AsyncHandle, String, Boolean, Int32)

Selects field values matching a search string.

### Declaration

```

          public Task<bool> SelectAsync(AsyncHandle asyncHandle, [QixName("qMatch")] string match, [QixName("qSoftLock")] bool softLock = false, [QixName("qExcludedValuesMode")] int excludedValuesMode = 0)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.AsyncHandle.htm) | asyncHandle | Handle to asynchronous method request |
| System.String | match | String to search for.<br>Can contain wild cards or numeric search criteria.<br>The characters &lt;&gt;"~()='[] have pre-defined meanings when used at the start of the string.<br>To use them, EnableSpecialCharacterEscapingInSearch needs to be enabled and the delimiter \ needs to precede the special character. |
| System.Boolean | softLock | Set to true to ignore locks; in that case, locked fields can be selected.<br>The default value is false. |
| System.Int32 | excludedValuesMode | Include excluded values in search. |

### Returns

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

### Implements

[IField.SelectAsync(AsyncHandle, String, Boolean, Int32)](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IField.SelectAsync.htm#Qlik_Engine_IField_SelectAsync_Qlik_Engine_AsyncHandle_System_String_System_Boolean_System_Int32_)

### Remarks

The operation is successful if qReturn is set to true.

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

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

Selects field values matching a search string.

### Declaration

```
public Task<T> SelectAsync<T>(AsyncHandle asyncHandle, Func<Response, T> onResult, [QixName("qMatch")] string match, [QixName("qSoftLock")] bool softLock = false, [QixName("qExcludedValuesMode")] int excludedValuesMode = 0)
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/November2025/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/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.Communication.IO.Response.htm), T&gt; | onResult | Continuation function |
| System.String | match | String to search for.<br>Can contain wild cards or numeric search criteria.<br>The characters &lt;&gt;"~()='[] have pre-defined meanings when used at the start of the string.<br>To use them, EnableSpecialCharacterEscapingInSearch needs to be enabled and the delimiter \ needs to precede the special character. |
| System.Boolean | softLock | Set to true to ignore locks; in that case, locked fields can be selected.<br>The default value is false. |
| System.Int32 | excludedValuesMode | Include excluded values in search. |

### Returns

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

### Type Parameters

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

### Implements

[IField.SelectAsync<T>(AsyncHandle, Func<Response, T>, String, Boolean, Int32)](https://help.qlik.com/en-US/sense-developer/November2025/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IField.SelectAsync.htm#Qlik_Engine_IField_SelectAsync__1_Qlik_Engine_AsyncHandle_System_Func_Qlik_Engine_Communication_IO_Response___0__System_String_System_Boolean_System_Int32_)

### Remarks

The operation is successful if qReturn is set to true.