Lezen in het Engels

Delen via


Lijstfuncties

Met deze functies worden lijstwaarden gemaakt en bewerkt.

Informatie

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 deterministisch aantal 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 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 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 true als een item in een lijst voldoet aan de voorwaarde.
List.Positions Retourneert een lijst met posities voor een invoerlijst.
List.Range Retourneert een aantal van items die beginnen bij een offset.
List.Select Selecteert de items die overeenkomen met een voorwaarde.
List.Single Retourneert het ene 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. Gegeven een lege lijst, retourneert het een lege lijst. Deze functie gebruikt een optionele parameter countOrCondition om het overslaan van meerdere waarden te ondersteunen.

Transformatiefuncties

Naam Beschrijving
List.Accumulate Verzamelt een resultaat uit de lijst. De functie start met de beginwaarde, past de accumulatorfunctie toe en retourneert het uiteindelijke resultaat.
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 waarbij een aantal items wordt verwijderd, beginnend vanaf een bepaalde beginpositie. 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 parameter countOrCondition.
List.RemoveItems Verwijder items uit list1 die aanwezig zijn in list2en krijg een nieuwe lijst als resultaat.
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 parameter countOrCondition.
List.Repeat Retourneert een lijst die de inhoud van een invoerlijst een aantal keer herhaalt.
List.ReplaceRange Retourneert een lijst die tellingswaarden in een lijst vervangt door een replaceWith lijst die begint bij een index.
List.RemoveMatchingItems Verwijdert alle voorkomens van de opgegeven waarden in de lijst.
List.RemoveNulls Hiermee verwijdert u null-waarden uit een lijst.
List.ReplaceMatchingItems Vervangt voorkomens van bestaande waarden in de lijst door nieuwe waarden met behulp van de opgegeven equationCriteria. Oude en nieuwe waarden worden geleverd door de replacements parameters. Er kan een optionele vergelijkingscriteriawaarde worden opgegeven om gelijkheidsvergelijkingen te beheren. Ga naar Parameterwaardenvoor meer informatie over vervangingsbewerkingen en vergelijkingscriteria.
List.ReplaceValue Zoekt in een lijst met waarden naar een bepaalde waarde en vervangt elke keer dat het voorkomt 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 Geeft true terug als een expressie in de lijst waar is
List.Contains Retourneert true als een waarde wordt gevonden in een lijst.
List.ContainsAll Retourneert true als alle items in waarden in de lijst staan.
List.ContainsAny Retourneert waar als een item uit de waarden in een lijst aanwezig is.
List.PositionOf Vindt de eerste plaats van een waarde in een lijst en retourneert de positie ervan.
List.PositionOfAny Vindt het eerste exemplaar van een waarde in de opgegeven 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.

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 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.Median 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.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 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 schatting op basis van een voorbeeld uit. 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 uit een lijst.

Numeriek

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.

Generatoren

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 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.