Oprette forespørgsler med QueryExpression

Artikel
03/03/2017

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

I Microsoft Dynamics 365 (online og i det lokale miljø) kan du bruge klassen QueryExpression til at opbygge en forespørgsel, der indeholder datafiltre og søgebetingelser, der definerer omfanget af en søgning i databasen ved hjælp af programmering. Et forespørgselsudtryk bruges til søgninger i ét objekt. Du kan for eksempel oprette en søgning for at vende tilbage til alle firmaer, der opfylder bestemte søgekriterier. Klassen QueryBase er den grundlæggende klasse for forespørgselsudtryk. Der er to afledte klasser: QueryExpression og QueryByAttribute. Klassen QueryExpression understøtter komplekse forespørgsler. Klassen QueryByAttribute er en simpel metode til at søge efter objekter, hvor attributter matcher angivne værdier.

Forespørgselsudtryk bruges i metoder, der henter mere end én post, som metoden IOrganizationService.RetrieveMultiple i meddelelser, der udfører en handling på et resultat, angivet i et forespørgselsudtryk, som BulkDeleteRequest, og når ID for en bestemt post ikke er kendt.

Desuden er der en ny attribut i organisationsobjektet, Organization.QuickFindRecordLimitEnabled. Når denne attribut Boolean er true, er der en grænse på hurtig søgning efter forespørgsler. Hvis en bruger angiver søgekriterier i Hurtig søgning, som ikke er selektive nok, vil systemet registrerer dette og stopper søgningen. Dette understøtter en hurtigere form for hurtig søgning og kan gøre en forskel hvad angår ydeevnen.

Advarsel
Hent ikke alle attributter i en forespørgsel på grund af den negative effekt på ydeevnen. Dette gælder især, hvis forespørgslen bruges som en parameter til en opdateringsforespørgsel. I en opdatering angives alle feltværdier, hvis alle attributter er inkluderet, selvom de er uændret og ofte udløser overlappende opdateringer til underordnede poster.

Der findes to andre måder at oprette forespørgsler på for at hente poster fra Microsoft Dynamics 365.FetchXML, det beskyttede Microsoft Dynamics 365 forespørgselssprog, kan bruges til at udføre visse forespørgsler ved hjælp af XML-baserede forespørgsler. Du kan finde flere oplysninger under Oprette forespørgsler med FetchXML. Du kan også bruge .NET-sprogintegreret forespørgsel (LINQ) til at skrive forespørgsler.Flere oplysninger:Opret forespørgsler med LINQ (.NET-sprogintegreret forespørgsel).

Hvis du vil gemme en forespørgsel, kan du konvertere den til FetchXML ved hjælp af QueryExpressionToFetchXmlRequest og gemme den som en gemt visning ved hjælp af objektet userquery.