# FindMatchingFieldsAsync Method

## Overloads

| [FindMatchingFieldsAsync(String, IEnumerable<String>)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.FindMatchingFieldsAsync.htm#Qlik_Engine_IApp_FindMatchingFieldsAsync_System_String_System_Collections_Generic_IEnumerable_System_String__) |  | Retrieves any fields that belong to the same archipelago as the specified field and that match at least one of the specified tags. |
| --- | --- | --- |
| [FindMatchingFieldsAsync(AsyncHandle, String, IEnumerable<String>)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.FindMatchingFieldsAsync.htm#Qlik_Engine_IApp_FindMatchingFieldsAsync_Qlik_Engine_AsyncHandle_System_String_System_Collections_Generic_IEnumerable_System_String__) |  | Retrieves any fields that belong to the same archipelago as the specified field and that match at least one of the specified tags. |
| [FindMatchingFieldsAsync<T>(AsyncHandle, Func<Response, T>, String, IEnumerable<String>)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.FindMatchingFieldsAsync.htm#Qlik_Engine_IApp_FindMatchingFieldsAsync__1_Qlik_Engine_AsyncHandle_System_Func_Qlik_Engine_Communication_IO_Response___0__System_String_System_Collections_Generic_IEnumerable_System_String__) |  | Retrieves any fields that belong to the same archipelago as the specified field and that match at least one of the specified tags. |

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

## FindMatchingFieldsAsync(String, IEnumerable&lt;String&gt;)

Retrieves any fields that belong to the same archipelago as the specified field and that match at least one of the specified tags.

### Declaration

```

          Task<IEnumerable<NxMatchingFieldInfo>> FindMatchingFieldsAsync([QixName("qFieldName")] string fieldName, [QixName("qTags")] IEnumerable<string> tags)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| System.String | fieldName | Name of the field.<br>This method looks for fields that belong to the same archipelago as this specified field. |
| System.Collections.Generic.IEnumerable&lt;System.String&gt; | tags | List of tags.<br>This method looks for fields that match at least one of the tags in this list. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task&lt;System.Collections.Generic.IEnumerable&lt;[NxMatchingFieldInfo](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.NxMatchingFieldInfo.htm)&gt;&gt; |  |

### Remarks

Tags set by Qlik Sense are prefixed by the `$` sign.

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

## FindMatchingFieldsAsync(AsyncHandle, String, IEnumerable&lt;String&gt;)

Retrieves any fields that belong to the same archipelago as the specified field and that match at least one of the specified tags.

### Declaration

```

          Task<IEnumerable<NxMatchingFieldInfo>> FindMatchingFieldsAsync(AsyncHandle asyncHandle, [QixName("qFieldName")] string fieldName, [QixName("qTags")] IEnumerable<string> tags)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.AsyncHandle.htm) | asyncHandle | Handle to asynchronous method request |
| System.String | fieldName | Name of the field.<br>This method looks for fields that belong to the same archipelago as this specified field. |
| System.Collections.Generic.IEnumerable&lt;System.String&gt; | tags | List of tags.<br>This method looks for fields that match at least one of the tags in this list. |

### Returns

| Type | Description |
| --- | --- |
| System.Threading.Tasks.Task&lt;System.Collections.Generic.IEnumerable&lt;[NxMatchingFieldInfo](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.NxMatchingFieldInfo.htm)&gt;&gt; |  |

### Remarks

Tags set by Qlik Sense are prefixed by the `$` sign.

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

## FindMatchingFieldsAsync&lt;T&gt;(AsyncHandle, Func&lt;Response, T&gt;, String, IEnumerable&lt;String&gt;)

Retrieves any fields that belong to the same archipelago as the specified field and that match at least one of the specified tags.

### Declaration

```
Task<T> FindMatchingFieldsAsync<T>(AsyncHandle asyncHandle, Func<Response, T> onResult, [QixName("qFieldName")] string fieldName, [QixName("qTags")] IEnumerable<string> tags)
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [AsyncHandle](https://help.qlik.com/en-US/sense-developer/May2026/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/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.Communication.IO.Response.htm), T&gt; | onResult | Continuation function |
| System.String | fieldName | Name of the field.<br>This method looks for fields that belong to the same archipelago as this specified field. |
| System.Collections.Generic.IEnumerable&lt;System.String&gt; | tags | List of tags.<br>This method looks for fields that match at least one of the tags in this list. |

### Returns

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

### Type Parameters

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

### Remarks

Tags set by Qlik Sense are prefixed by the `$` sign.