Delen via

Lijstfuncties

  • Artikel

Met deze functies worden lijstwaarden gemaakt en bewerkt.

Informatie

Naam Beschrijving
List.Count Retourneert het aantal items in een lijst.
List.IsEmpty Retourneert true als de lijst leeg is.
List.NonNullCount Retourneert het aantal items dat niet null is in de lijst.

Selectie

Naam Beschrijving
List.Alternate Retourneert een lijst die bestaat uit alle oneven genummerde offsetelementen in een lijst.
List.Buffer Buffert een lijst.
List.Distinct Retourneert een lijst met waarden met dubbele waarden die zijn verwijderd.
List.FindText Retourneert een lijst met waarden (inclusief recordvelden) die de opgegeven tekst bevatten.
List.First Retourneert de eerste waarde van de lijst of de opgegeven standaardwaarde als deze leeg is.
List.FirstN Retourneert de eerste set items in de lijst door op te geven hoeveel items moeten worden geretourneerd of een in aanmerking komende voorwaarde.
List.InsertRange Hiermee worden waarden in een lijst in de opgegeven index ingevoegd.
List.IsDistinct Geeft aan of er duplicaten in de lijst staan.
List.Last Retourneert de laatste waarde van de lijst of de opgegeven standaardwaarde als deze leeg is.
List.LastN Retourneert de laatste waarde in de lijst. U kunt eventueel opgeven hoeveel waarden moeten worden geretourneerd of een in aanmerking komende voorwaarde.
List.MatchesAll Retourneert true als aan de voorwaardefunctie wordt voldaan door alle waarden in de lijst.
List.MatchesAny Retourneert true als aan de voorwaardefunctie wordt voldaan door een willekeurige waarde.
List.Positions Retourneert een lijst met offsets voor de invoer.
List.Range Retourneert een subset van de lijst die begint bij een offset.
List.Select Retourneert een lijst met waarden die overeenkomen met de voorwaarde.
List.Single Retourneert het ene lijstitem voor een lijst van lengte één, anders wordt een uitzondering opgewekt.
List.SingleOrDefault Retourneert het ene lijstitem voor een lijst met lengte één en de standaardwaarde voor een lege lijst.
List.Skip Retourneert een lijst die het opgegeven aantal elementen aan het begin van de lijst overslaat.

Transformatiefuncties

Naam Beschrijving
List.Accumulate AAccumulateert een samenvattingswaarde van de items in de lijst.
List.Combine Retourneert één lijst door meerdere lijsten te combineren.
List.ConformToPageReader Deze functie is alleen bedoeld voor intern gebruik.
List.RemoveFirstN Retourneert een lijst die het opgegeven aantal elementen aan het begin van de lijst overslaat.
List.RemoveItems Hiermee verwijdert u items uit de eerste lijst die aanwezig zijn in de tweede lijst.
List.RemoveLastN Retourneert een lijst die het opgegeven aantal elementen van het einde van de lijst verwijdert.
List.RemoveMatchingItems Verwijdert alle voorkomens van de invoerwaarden.
List.RemoveNulls Hiermee verwijdert u alle null waarden uit de opgegeven lijst.
List.RemoveRange Verwijdert een aantal waarden vanaf een aangegeven positie.
List.Repeat Retourneert een lijst die bestaat uit count herhalingen van de oorspronkelijke lijst.
List.ReplaceMatchingItems Vervangt voorkomens van bestaande waarden in de lijst door nieuwe waarden die voldoen aan de voorwaarde.
List.ReplaceRange Vervangt count aantal waarden vanaf position door de vervangende waarden.
List.ReplaceValue Zoekt in een lijst naar de opgegeven waarde en vervangt deze.
List.Reverse Hiermee wordt de volgorde van waarden in de lijst omgekeerd.
List.Split Hiermee wordt de opgegeven lijst gesplitst in een lijst met lijsten met behulp van het opgegeven paginaformaat.
List.Transform Retourneert een nieuwe lijst met waarden die zijn berekend uit deze lijst.
List.TransformMany Retourneert een lijst waarvan de elementen worden getransformeerd uit de invoerlijst met behulp van opgegeven functies.
List.Zip Retourneert een lijst met lijsten door items op dezelfde positie in meerdere lijsten te combineren.

Lidmaatschapsfuncties

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

Naam Beschrijving
List.AllTrue Retourneert true als alle expressies waar zijn.
List.AnyTrue Retourneert waar als een van de expressies waar is.
List.Contains Geeft aan of de lijst de waarde bevat.
List.ContainsAll Geeft aan waar een lijst alle waarden in een andere lijst bevat.
List.ContainsAny Geeft aan waar een lijst een van de waarden in een andere lijst bevat.
List.PositionOf Retourneert de verschuiving(en) van een waarde in een lijst.
List.PositionOfAny Retourneert de eerste verschuiving van een waarde in een lijst.

Bewerkingen instellen

Naam Beschrijving
List.Difference Retourneert het verschil van de twee opgegeven lijsten.
List.Intersect Retourneert het snijpunt van de lijstwaarden die in de invoer zijn gevonden.
List.Union Retourneert de samenvoeging van de lijstwaarden die in de invoer zijn gevonden.

Bestellen

Functies voor ordenen 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 een Expression.Error gegooid.

Vergelijkbare gegevenstypen zijn:

  • Getal
  • Duur
  • Datum/tijd
  • Tekst
  • Logisch
  • Nul
Naam Beschrijving
List.Max Retourneert de maximumwaarde of de standaardwaarde voor een lege lijst.
List.MaxN Retourneert de maximumwaarde(s) in de lijst. Het aantal waarden dat moet worden geretourneerd of een filtervoorwaarde moet worden opgegeven.
List.Median Retourneert de mediaanwaarde in de lijst.
List.Min Retourneert de minimumwaarde of de standaardwaarde voor een lege lijst.
List.MinN Retourneert de minimumwaarde(s) in de lijst. Het aantal waarden dat moet worden geretourneerd of een filtervoorwaarde kan worden opgegeven.
List.Sort Hiermee sorteert u een lijst met gegevens op basis van de opgegeven criteria.
List.Percentile 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 het gemiddelde van de waarden. Werkt met waarden voor getal, datum, datum/tijd, datum/tijdzone en duur.
List.Mode Retourneert de meest voorkomende waarde in de lijst.
List.Modes Retourneert een lijst met de meest voorkomende waarden in de lijst.
List.StandardDeviation Retourneert een steekproefgebaseerde schatting van de standaarddeviatie. Met deze functie wordt een schatting op basis van een voorbeeld uitgevoerd. Het resultaat is een getal voor getallen en een duur voor datum/tijd en periodes.

Toevoeging

Deze functies werken via homogene lijsten met getallen of duur.

Naam Beschrijving
List.Sum Retourneert de som van de items in de lijst.

Numeriek

Deze functies werken alleen over getallen.

Naam Beschrijving
List.Covariance Retourneert de covariantie tussen de twee lijsten met getallen.
List.Product Retourneert het product van de getallen in de lijst.

Generatoren

Met deze functies wordt een lijst met waarden gegenereerd.

Naam Beschrijving
List.Dates Hiermee genereert u een lijst met date waarden op basis van een initiële waarde, telling en incrementele duurwaarde.
List.DateTimes Hiermee genereert u een lijst met datetime waarden op basis van een initiële waarde, telling en incrementele duurwaarde.
List.DateTimeZones Hiermee genereert u een lijst met datetimezone waarden op basis van een initiële waarde, telling en incrementele duurwaarde.
List.Durations Hiermee genereert u een lijst met duration waarden op basis van een initiële waarde, telling en incrementele duurwaarde.
List.Generate Hiermee wordt een lijst met waarden gegenereerd.
List.Numbers Retourneert een lijst met getallen op basis van een initiële waarde, aantal en optionele incrementele waarde.
List.Random Retourneert een lijst met willekeurige getallen.
List.Times Hiermee genereert u een lijst met time waarden op basis van een initiële waarde, telling en incrementele duurwaarde.

Parameterwaarden

Specificatie van voorvallen

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.Distinctvoor 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 Sorteervolgordevoor 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.Sortvoor 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, dat alle voorvallen van de oude waarde in de lijst moet vervangen.