# GetMatchingFieldsAsync Method

## Overloads

| [GetMatchingFieldsAsync(IEnumerable<String>, NxMatchingFieldMode)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.GetMatchingFieldsAsync.htm#Qlik_Engine_App_GetMatchingFieldsAsync_System_Collections_Generic_IEnumerable_System_String__Qlik_Engine_NxMatchingFieldMode_) |  | Retrieves any fields that match all of the specified tags or just one of them in the data model of an app. |
| --- | --- | --- |
| [GetMatchingFieldsAsync(AsyncHandle, IEnumerable<String>, NxMatchingFieldMode)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.GetMatchingFieldsAsync.htm#Qlik_Engine_App_GetMatchingFieldsAsync_Qlik_Engine_AsyncHandle_System_Collections_Generic_IEnumerable_System_String__Qlik_Engine_NxMatchingFieldMode_) |  | Retrieves any fields that match all of the specified tags or just one of them in the data model of an app. |
| [GetMatchingFieldsAsync<T>(AsyncHandle, Func<Response, T>, IEnumerable<String>, NxMatchingFieldMode)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.App.GetMatchingFieldsAsync.htm#Qlik_Engine_App_GetMatchingFieldsAsync__1_Qlik_Engine_AsyncHandle_System_Func_Qlik_Engine_Communication_IO_Response___0__System_Collections_Generic_IEnumerable_System_String__Qlik_Engine_NxMatchingFieldMode_) |  | Retrieves any fields that match all of the specified tags or just one of them in the data model of an app. |

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

## GetMatchingFieldsAsync(IEnumerable&lt;String&gt;, NxMatchingFieldMode)

Retrieves any fields that match all of the specified tags or just one of them in the data model of an app.

### Declaration

```

          public Task<IEnumerable<NxMatchingFieldInfo>> GetMatchingFieldsAsync([QixName("qTags")] IEnumerable<string> tags, [QixName("qMatchingFieldMode")] NxMatchingFieldMode matchingFieldMode = NxMatchingFieldMode.MATCHINGFIELDMODE_MATCH_ALL)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| System.Collections.Generic.IEnumerable&lt;System.String&gt; | tags | List of tags.<br>The `GetMatchingFields` method looks for fields that match one or all of the tags in this list, depending on the value of `qMatchingFieldMode` . |
| [NxMatchingFieldMode](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.NxMatchingFieldMode.htm) | matchingFieldMode | Matching field mode.<br>The default value is MATCHINGFIELDMODE\_MATCH\_ALL. |

### 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; |  |

### Implements

[IApp.GetMatchingFieldsAsync(IEnumerable<String>, NxMatchingFieldMode)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.GetMatchingFieldsAsync.htm#Qlik_Engine_IApp_GetMatchingFieldsAsync_System_Collections_Generic_IEnumerable_System_String__Qlik_Engine_NxMatchingFieldMode_)

### Remarks

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

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

## GetMatchingFieldsAsync(AsyncHandle, IEnumerable&lt;String&gt;, NxMatchingFieldMode)

Retrieves any fields that match all of the specified tags or just one of them in the data model of an app.

### Declaration

```

          public Task<IEnumerable<NxMatchingFieldInfo>> GetMatchingFieldsAsync(AsyncHandle asyncHandle, [QixName("qTags")] IEnumerable<string> tags, [QixName("qMatchingFieldMode")] NxMatchingFieldMode matchingFieldMode = NxMatchingFieldMode.MATCHINGFIELDMODE_MATCH_ALL)
    
  
```

### 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.Collections.Generic.IEnumerable&lt;System.String&gt; | tags | List of tags.<br>The `GetMatchingFields` method looks for fields that match one or all of the tags in this list, depending on the value of `qMatchingFieldMode` . |
| [NxMatchingFieldMode](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.NxMatchingFieldMode.htm) | matchingFieldMode | Matching field mode.<br>The default value is MATCHINGFIELDMODE\_MATCH\_ALL. |

### 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; |  |

### Implements

[IApp.GetMatchingFieldsAsync(AsyncHandle, IEnumerable<String>, NxMatchingFieldMode)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.GetMatchingFieldsAsync.htm#Qlik_Engine_IApp_GetMatchingFieldsAsync_Qlik_Engine_AsyncHandle_System_Collections_Generic_IEnumerable_System_String__Qlik_Engine_NxMatchingFieldMode_)

### Remarks

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

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

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

Retrieves any fields that match all of the specified tags or just one of them in the data model of an app.

### Declaration

```
public Task<T> GetMatchingFieldsAsync<T>(AsyncHandle asyncHandle, Func<Response, T> onResult, [QixName("qTags")] IEnumerable<string> tags, [QixName("qMatchingFieldMode")] NxMatchingFieldMode matchingFieldMode = NxMatchingFieldMode.MATCHINGFIELDMODE_MATCH_ALL)
```

### 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.Collections.Generic.IEnumerable&lt;System.String&gt; | tags | List of tags.<br>The `GetMatchingFields` method looks for fields that match one or all of the tags in this list, depending on the value of `qMatchingFieldMode` . |
| [NxMatchingFieldMode](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.NxMatchingFieldMode.htm) | matchingFieldMode | Matching field mode.<br>The default value is MATCHINGFIELDMODE\_MATCH\_ALL. |

### Returns

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

### Type Parameters

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

### Implements

[IApp.GetMatchingFieldsAsync<T>(AsyncHandle, Func<Response, T>, IEnumerable<String>, NxMatchingFieldMode)](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/NetSDKAPIref/Content/Qlik.Engine.IApp.GetMatchingFieldsAsync.htm#Qlik_Engine_IApp_GetMatchingFieldsAsync__1_Qlik_Engine_AsyncHandle_System_Func_Qlik_Engine_Communication_IO_Response___0__System_Collections_Generic_IEnumerable_System_String__Qlik_Engine_NxMatchingFieldMode_)

### Remarks

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