ApplicationService.Get Method (String)

Returns a collection of Application objects that respects filtering.

Namespace: Citrix.SDK.AppDNA
Assembly: Citrix.SDK.AppDNA (in Citrix.SDK.AppDNA.dll) Version: 7.11.0.0 (7.11.0.0)

Syntax

C

public Collection<Application> Get(
    string filterQuery
)

VB

Public Function Get ( 
    filterQuery As String
) As Collection(Of Application)

Parameters

 

filterQuery

Type: System.String
The filter query string. See remarks for more details.

Return Value

Type: Collection(Application)
Returns a collection of the requested Application objects.

Remarks

The format for the query string is similar to the SQL WHERE clause. Allowed operators are: IS NULL, = (Equals), > (Greater than), < (Less than), >= (Greater than or equal), <= (Less than or equal), <> (Not equal), LIKE (contains), AND, OR, and () for precedence String literals are delimited by apostrophes. Use a double apostrophe to represent an apostrophe in the string literal. Arbitrary field names are allowed. Field names will be assumed to represent a matching Application property. If there is no matching property they will be assumed to an ApplicationAttributeDefinition identifier. To filter with an ApplicationAttributeDefinition identifier when it also matches a property name, prefix it with "Attribute.". e.g.

Get("Attribute.Manufacturer='xxx'")

; If there is no ApplicationAttributeDefinition with the specified identifier, then an exception will be thrown. When comparing a property that holds a value that is from an enumeration, specify the enumeration value name as a string. e.g.

Get("SourceCategory='WebApplication'")

. When an Application has not had a value set for a given ApplicationAttributeDefinition, it will behave as if it has NULL for that attribute. Where an ApplicationAttributeDefinition identifier contains spaces, surround it with square brackets. e.g.

Get("[Application tester]='WebApplication'")

ApplicationAttributeDefinitions for which IsReportDependent is true can be queried by using the ApplicationAttributeDefinition.Identifier value and the ReportConfiguration identifier separated by a period. e.g.

Get("analyzed_date.Win7Module IS NOT NULL")

Leaving off the ReportConfiguration identifier matches values for any ReportConfiguration for that ApplicationAttributeDefinition. e.g.

Get("analyzed_date IS NOT NULL")

When using datetime string literals, it is recommended to use the ISO 8601 format. YYYY-MM-DDThh:mm:ss[.mmm] or YYYYMMDD[ hh:mm:ss[.mmm]] or . e.g.

Get("analyzed_date.Win7Module > 20140123")

See Also

Reference

ApplicationService Class
Get Overload
Citrix.SDK.AppDNA Namespace