Share via

Lijstfuncties

  • Artikel

Met deze functies worden lijstwaarden gemaakt en bewerkt.

Gegevens

Naam Beschrijving
List.Count Retourneert het aantal items in een lijst.
List.NonNullCount Geeft als resultaat het aantal items in een lijst met uitzondering van null-waarden
List.IsEmpty Retourneert of een lijst leeg is.

Selectie

Naam Beschrijving
List.Alternate Retourneert een lijst met de items die zijn afgewisseld van de oorspronkelijke lijst op basis van een telling, optionele repeatInterval en een optionele offset.
List.Buffer Buffert de lijst in het geheugen. Het resultaat van deze aanroep is een stabiele lijst, wat betekent dat het een determinimic count en de volgorde van items heeft.
List.Distinct Hiermee filtert u een lijst omlaag door duplicaten te verwijderen. Er kan een optionele vergelijkingscriteriawaarde worden opgegeven om gelijkheidsvergelijking te bepalen. De eerste waarde van elke gelijkheidsgroep wordt gekozen.
List.FindText Zoekt in een lijst met waarden, inclusief recordvelden, naar een tekstwaarde.
List.First Retourneert de eerste waarde van de lijst of de opgegeven standaardwaarde als deze leeg is. Retourneert het eerste item in de lijst of de optionele standaardwaarde als de lijst leeg is. Als de lijst leeg is en er geen standaardwaarde is opgegeven, retourneert de functie.
List.FirstN Retourneert de eerste set items in de lijst door op te geven hoeveel items moeten worden geretourneerd of door een in aanmerking komende voorwaarde die is opgegeven door countOrCondition.
List.InsertRange Hiermee voegt u items uit waarden in de opgegeven index in de invoerlijst in.
List.IsDistinct Retourneert of een lijst uniek is.
List.Last Retourneert de laatste set items in de lijst door op te geven hoeveel items moeten worden geretourneerd of door een in aanmerking komende voorwaarde die is opgegeven door countOrCondition.
List.LastN Retourneert de laatste set items in een lijst door op te geven hoeveel items moeten worden geretourneerd of een in aanmerking komende voorwaarde.
List.MatchesAll Retourneert waar als alle items in een lijst voldoen aan een voorwaarde.
List.MatchesAny Retourneert waar als een item in een lijst voldoet aan een voorwaarde.
List.Positions Retourneert een lijst met posities voor een invoerlijst.
List.Range Retourneert een aantal items die beginnen bij een offset.
List.Select Selecteert de items die overeenkomen met een voorwaarde.
List.Single Retourneert het enkele item van de lijst of genereert een Expression.Error als de lijst meer dan één item heeft.
List.SingleOrDefault Retourneert één item uit een lijst.
List.Skip Hiermee wordt het eerste item van de lijst overgeslagen. Op basis van een lege lijst wordt een lege lijst geretourneerd. Deze functie gebruikt een optionele parameter countOrCondition ter ondersteuning van het overslaan van meerdere waarden.

Transformatiefuncties

Naam Beschrijving
List.Accumulate Verzamelt een resultaat uit de lijst. Vanaf de beginwaarde van deze functie wordt de accumulatorfunctie toegepast en wordt het uiteindelijke resultaat geretourneerd.
List.Combine Hiermee wordt een lijst met lijsten samengevoegd tot één lijst.
List.ConformToPageReader Deze functie is alleen bedoeld voor intern gebruik.
List.RemoveRange Retourneert een lijst die het aantal items verwijdert dat begint bij verschuiving. Het standaardaantal is 1.
List.RemoveFirstN Retourneert een lijst met het opgegeven aantal elementen dat is verwijderd uit de lijst vanaf het eerste element. Het aantal verwijderde elementen is afhankelijk van de optionele countOrCondition parameter.
List.RemoveItems Hiermee verwijdert u items uit list1 die aanwezig zijn in list2en retourneert u een nieuwe lijst.
List.RemoveLastN Retourneert een lijst met het opgegeven aantal elementen dat is verwijderd uit de lijst vanaf het laatste element. Het aantal verwijderde elementen is afhankelijk van de optionele countOrCondition parameter.
List.Repeat Retourneert een lijst die de inhoud van een aantal invoerlijsten herhaalt.
List.ReplaceRange Retourneert een lijst die tellingswaarden in een lijst vervangt door een replaceWith lijst die begint bij een index.
List.RemoveMatchingItems Hiermee verwijdert u alle exemplaren van de opgegeven waarden in de lijst.
List.RemoveNulls Hiermee verwijdert u null-waarden uit een lijst.
List.ReplaceMatchingItems Vervangt exemplaren van bestaande waarden in de lijst door nieuwe waarden met behulp van de opgegeven equationCriteria. Oude en nieuwe waarden worden opgegeven door de replacements parameters. Er kan een optionele vergelijkingscriteriawaarde worden opgegeven om gelijkheidsvergelijkingen te beheren. Ga naar Parameterwaarden voor meer informatie over vervangingsbewerkingen en vergelijkingscriteria.
List.ReplaceValue Zoekt in een lijst met waarden voor de waarde en vervangt elke instantie door de vervangende waarde.
List.Reverse Retourneert een lijst die de items in een lijst omdraait.
List.Split Hiermee wordt de opgegeven lijst gesplitst in een lijst met lijsten met behulp van het opgegeven paginaformaat.
List.Transform Voert de functie uit voor elk item in de lijst en retourneert de nieuwe lijst.
List.TransformMany Retourneert een lijst waarvan de elementen uit de invoerlijst worden geprojecteerd.

Lidmaatschapsfuncties

Omdat alle waarden kunnen worden getest op gelijkheid, kunnen deze functies worden uitgevoerd via heterogene lijsten.

Naam Beschrijving
List.AllTrue Retourneert waar als alle expressies in een lijst waar zijn
List.AnyTrue Retourneert waar als een expressie in een lijst waar is
List.Contains Retourneert waar als een waarde wordt gevonden in een lijst.
List.ContainsAll Retourneert waar als alle items in waarden in een lijst worden gevonden.
List.ContainsAny Retourneert waar als een item in waarden in een lijst wordt gevonden.
List.PositionOf Hiermee wordt het eerste exemplaar van een waarde in een lijst gevonden en wordt de positie ervan geretourneerd.
List.PositionOfAny Zoekt het eerste exemplaar van een waarde in waarden en retourneert de positie.

Bewerkingen instellen

Naam Beschrijving
List.Difference Retourneert de items in lijst 1 die niet worden weergegeven in lijst 2. Dubbele waarden worden ondersteund.
List.Intersect Retourneert een lijst uit een lijst met lijsten en kruist algemene items in afzonderlijke lijsten. Dubbele waarden worden ondersteund.
List.Union Retourneert een lijst uit een lijst met lijsten en samenvoegt de items in de afzonderlijke lijsten. De geretourneerde lijst bevat alle items in invoerlijsten. Dubbele waarden worden vergeleken als onderdeel van de Unie.
List.Zip Retourneert een lijst met lijsten waarin items op dezelfde positie worden gecombineerd.

Ordenen

Volgordefuncties voeren vergelijkingen uit. Alle waarden die worden vergeleken, moeten met elkaar vergelijkbaar zijn. Dit betekent dat ze allemaal afkomstig moeten zijn van hetzelfde gegevenstype (of null bevatten, waarmee altijd het kleinste wordt vergeleken). Anders wordt er een Expression.Error gegooid.

Vergelijkbare gegevenstypen zijn:

  • Aantal
  • Duur
  • Datum/tijd
  • Sms verzenden
  • Logisch
  • Nul
Naam Beschrijving
List.Max Retourneert het maximumitem in een lijst of de optionele standaardwaarde als de lijst leeg is.
List.MaxN Retourneert de maximumwaarden in de lijst. Het aantal waarden dat moet worden geretourneerd of een filtervoorwaarde moet worden opgegeven.
List.Mediaan Retourneert het mediaanitem uit een lijst.
List.Min Retourneert het minimumitem in een lijst of de optionele standaardwaarde als de lijst leeg is.
List.MinN Retourneert de minimumwaarden in een lijst. Het aantal waarden dat moet worden geretourneerd of een filtervoorwaarde kan worden opgegeven.
List.Sort Retourneert een gesorteerde lijst met vergelijkingscriterium.
List.Percentiel Retourneert een of meer percentielen die overeenkomen met de gegeven waarschijnlijkheden.

Gemiddelden

Deze functies werken via homogene lijsten met getallen, datum/tijd en duur.

Naam Beschrijving
List.Average Retourneert een gemiddelde waarde uit een lijst in het gegevenstype van de waarden in de lijst.
List.Mode Retourneert een item dat het meest voorkomt in een lijst.
List.Modes Retourneert alle items die met dezelfde maximale frequentie worden weergegeven.
List.StandardDeviation Retourneert de standaarddeviatie van een lijst met waarden. List.StandardDeviation voert een steekproefgebaseerde schatting uit. Het resultaat is een getal voor getallen en een duur voor Datum/tijd en Duur.

Aanvullend

Deze functies werken via homogene lijsten met getallen of duur.

Naam Beschrijving
List.Sum Retourneert de som uit een lijst.

Cijfers

Deze functies werken alleen over getallen.

Naam Beschrijving
List.Covariance Retourneert de covariantie van twee lijsten als een getal.
List.Product Retourneert het product uit een lijst met getallen.

Generators

Met deze functies wordt een lijst met waarden gegenereerd.

Naam Beschrijving
List.Dates Retourneert een lijst met datumwaarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde.
List.DateTimes Retourneert een lijst met datum/tijd-waarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde.
List.DateTimeZones Retourneert een lijst met datum/tijdzone-waarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde.
List.Durations Retourneert een lijst met duurwaarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde.
List.Generate Hiermee wordt een lijst met waarden gegenereerd.
List.Numbers Retourneert een lijst met getallen uit het aantal grootten vanaf het begin en voegt een verhoging toe. De increment wordt standaard ingesteld op 1.
List.Random Retourneert een lijst met aantal willekeurige getallen, met een optionele seed-parameter.
List.Times Retourneert een lijst met tijdwaarden van het aantal grootten, beginnend bij het begin.

Parameterwaarden

Specificatie van exemplaren

Sorteervolgorde

Vergelijkingscriteria

Vergelijkingscriteria voor lijstwaarden kunnen worden opgegeven als:

  • Een functiewaarde die een van de volgende is:
    • Een sleutelkiezer die de waarde in de lijst bepaalt om de gelijkheidscriteria toe te passen.
    • Een vergelijkingsfunctie die wordt gebruikt om het soort vergelijking op te geven dat moet worden toegepast. Ingebouwde vergelijkingsfuncties kunnen worden opgegeven: ga naar Comparer-functies.
  • Een lijstwaarde met:
    • Precies twee items.
    • Het eerste element is de sleutelkiezer zoals hierboven is opgegeven.
    • Het tweede element is een vergelijkingsfunctie zoals hierboven is opgegeven.

Ga naar List.Distinct voor meer informatie en voorbeelden.

Vergelijkingscriteria

Het vergelijkingscriterium kan worden opgegeven als een van de volgende waarden:

  • Een getalwaarde om een sorteervolgorde op te geven. Ga naar Sorteervolgorde voor meer informatie.
  • Als u een sleutel wilt berekenen die moet worden gebruikt voor sorteren, kunt u een functie van één argument gebruiken.
  • Als u zowel een sleutel als een controlevolgorde wilt selecteren, kan het vergelijkingscriterium een lijst met de sleutel en volgorde zijn.
  • Om de vergelijking volledig te beheren, kan een functie van twee argumenten worden gebruikt die -1, 0 of 1 retourneert op basis van de relatie tussen de linker- en rechterinvoer. Value.Compare is een methode die kan worden gebruikt om deze logica te delegeren.

Ga naar List.Sort voor meer informatie en voorbeelden.

Vervangingsbewerkingen

Vervangingsbewerkingen worden opgegeven door een lijstwaarde. Elk item van deze lijst moet het volgende zijn:

  • Een lijstwaarde van precies twee items.
  • Het eerste item is de oude waarde in de lijst die moet worden vervangen.
  • Het tweede item is de nieuwe waarde, die alle exemplaren van de oude waarde in de lijst moet vervangen.