Ger information om en datakälla.

Översikt

Datakällor kan ge mängder av information för att optimera användarupplevelsen.

Du kan använda information på kolumn-nivå för att validera användarindata och ge omedelbar feedback till användaren innan du använder Patch-funktionen. Funktionen Validate använder sig av samma information.

Du kan använda informationen på datakällenivå, för att till exempel inaktivera eller dölja knapparna Redigera och Ny för användare som inte har behörighet att redigera och skapa poster.

Det varierar hur mycket information datakällorna ger, ibland kan de inte ge någon alls. Samlingar innehåller ingen information. Om en information inte lämnas används en standard, eller tom returneras.

Beskrivning

Kolumninformation

Du kan använda DataSourceInfo att hämta information om en viss kolumn i en datakälla:

Information Argument Resultattyp Beskrivning
DataSourceInfo.DisplayName Sträng Visningsnamn för kolumnen. Returnerar kolumnnamnet om inget visningsnamn har definierats.
DataSourceInfo.MaxLength Number Maximalt antal tecken som kolumnen kan innehålla. Gäller enbart för kolumner som innehåller strängar. Returnerar tom om maximalt värde inte anges.
DataSourceInfo.MaxValue Number Maximalt numeriskt värde som en kolumn kan innehålla. Gäller enbart för kolumner som innehåller tal. Returnerar tom om maximalt värde inte anges.
DataSourceInfo.MinValue Number Minsta numeriska värde som en kolumn kan innehålla. Gäller enbart för kolumner som innehåller tal. Returnerar tom om minsta värde inte anges.
DataSourceInfo.Required Booleskt Krävs det ett värde för den här kolumnen? Returnerar falskt om detta inte anges av datakällan.

Det tredje argumentet är namnet på en kolumn som en sträng. Till exempel skulle kolumnen Phone i samlingen People skickas som "Phone" inklusive dubbla citattecken.

Information om datakälla

Du kan även använda DataSourceInfo för att hämta information om en datakälla som helhet:

Information Argument Resultattyp Beskrivning
DataSourceInfo.CreatePermission Booleskt Har den aktuella användaren behörighet att skapa poster i den här datakällan? Returnerar true om detta inte anges av datakällan.
DataSourceInfo.DeletePermission Booleskt Har den aktuella användaren behörighet att ta bort poster i den här datakällan? Returnerar true om detta inte anges av datakällan.
DataSourceInfo.EditPermission Booleskt Har den aktuella användaren behörighet att redigera poster i den här datakällan? Returnerar true om detta inte anges av datakällan.
DataSourceInfo.ReadPermission Booleskt Har den aktuella användaren behörighet att läsa poster i den här datakällan? Returnerar true om detta inte anges av datakällan.

Syntax

DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource – Krävs. Datakällan som ska användas.
  • Information – obligatoriskt. Den typ av information som du vill hämta.
  • ColumnName – valfritt. För information på kolumnnivå, kolumnnamnet som en sträng. Kolumnen Phone skulle skickas som "Phone" inklusive dubbla citattecken. För information på datakällenivå kan inte ColumnName-argumentet användas.

Exempel

Exemplen i det här avsnittet använder en datakälla med namnet IceCream:

Datakällan har också lämnat den här informationen:

  • Visningsnamnet för Quantity är "Lagersaldo".
  • Den maximala längden på Flavor är 30 tecken.
  • Kolumnen Flavor måste innehålla ett värde. Kolumnen Quantity är inte obligatorisk.
  • Minsta värde för Quantity är 0.
  • Maximalt värde för Quantity är 100.
  • Den aktuella användaren kan läsa och redigera posterna för datakällan IceCream, men kan inte skapa eller ta bort poster.
Formel Beskrivning Resultat
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Returnerar visningsnamnet för kolumnen Quantity i datakällan IceCream. "Lagersaldo"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Returnerar den maximala längden på strängen för kolumnen Flavor i datakällan IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) Är kolumnen Flavor i datakällan IceCream obligatorisk? true
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) Är kolumnen Quantity i datakällan IceCream obligatorisk? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Returnerar det maximala numeriska värdet för kolumnen Quantity i datakällan IceCream. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Returnerar det minsta numeriska värdet för kolumnen Quantity i datakällan IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Kan den aktuella användaren läsa poster i datakällan IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Kan den aktuella användaren redigera poster i datakällan IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Kan den aktuella användaren skapa poster i datakällan IceCream? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Kan den aktuella användaren ta bort poster i datakällan IceCream? false