Funzione DataSourceInfo in PowerAppsDataSourceInfo function in PowerApps

Restituisce informazioni su un'origine dati.Provides information about a data source.

PanoramicaOverview

Le origini dati possono offrire un'ampia gamma di informazioni per ottimizzare l'esperienza dell'utente.Data sources can provide a wealth of information to optimize the user experience.

È possibile usare informazioni a livello colonna per convalidare l'input utente e inviare feedback immediato all'utente prima di usare la funzione Patch.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. La funzione Validate usa le stesse informazioni.The Validate function uses this same information.

È possibile usare le informazioni a livello di origine dati, ad esempio per disabilitare o nascondere i pulsanti Modifica e Nuovo agli utenti che non hanno autorizzazioni per creare e modificare record.You can use information at the data-source level, for example, to disable or hide Edit and New buttons for users who don't have permissions to edit and create records.

Le origini dati variano in base alla quantità di informazioni che offrono e potrebbero anche non includere alcuna informazione.Data sources vary in how much information they provide, including not providing any at all. Le raccolte non offrono informazioni.Collections provide no information. Se non viene specificata alcuna informazione, viene usata l'impostazione predefinita o viene restituito blank.If a piece of information isn't provided, a default is used, or blank is returned.

DescrizioneDescription

Informazioni sulle colonneColumn information

È possibile usare la funzione DataSourceInfo per ottenere informazioni su una determinata colonna di un'origine dati:You can use DataSourceInfo to obtain information about a particular column of a data source:

Argomento delle informazioniInformation Argument Tipo restituitoResult Type DescrizioneDescription
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName StringaString Il nome visualizzato della colonna.Display name for the column. Se non è definito alcun nome visualizzato, restituisce il nome della colonna.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength NumeroNumber Il numero massimo di caratteri che la colonna può contenere.Maximum number of characters that the column can hold. Si applica solo alle colonne che contengono stringhe.Applies only to columns that contain strings. Se non viene impostato un valore massimo, restituisce blank.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue NumeroNumber Il valore numerico massimo che può essere incluso in una colonna.Maximum numeric value that a column can hold. Si applica solo alle colonne che contengono numeri.Applies only to columns that contain numbers. Se non viene impostato un valore massimo, restituisce blank.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue NumeroNumber Il valore numerico minimo che può essere incluso in una colonna.Minimum numeric value that a column can hold. Si applica solo alle colonne che contengono numeri.Applies only to columns that contain numbers. Se non viene impostato un valore minimo, restituisce blank.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required BooleanoBoolean È un valore obbligatorio per questa colonna?Is a value required for this column? Se non è impostato dall'origine dati, restituisce false.If not set by the data source, returns false.

Il terzo argomento è il nome di una colonna di tipo stringa.The third argument is the name of a column as a string. Ad esempio, la colonna Phone nella raccolta People verrebbe passata come "Phone", incluse le virgolette doppie.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

Informazioni sull'origine datiData-source information

È possibile usare la funzione DataSourceInfo per ottenere informazioni su un'origine dati intera:You can also use DataSourceInfo to obtain information about a data source as a whole:

Argomento delle informazioniInformation Argument Tipo restituitoResult Type DescrizioneDescription
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues BooleanoBoolean Quali tipi di autorizzazioni è possibile concedere agli utenti per questa origine dati?What types of permissions can users be granted for this data source? Se non è impostato dall'origine dati, restituisce blank.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission BooleanoBoolean L'utente corrente ha le autorizzazioni per creare record in questa origine dati?Does the current user have permission to create records in this data source? Se non è impostato dall'origine dati, restituisce true.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission BooleanoBoolean L'utente corrente ha le autorizzazioni per eliminare record in questa origine dati?Does the current user have permission to delete records in this data source? Se non è impostato dall'origine dati, restituisce true.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission BooleanoBoolean L'utente corrente ha le autorizzazioni per modificare record in questa origine dati?Does the current user have permission to edit records in this data source? Se non è impostato dall'origine dati, restituisce true.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission BooleanoBoolean L'utente corrente ha le autorizzazioni per leggere record in questa origine dati?Does the current user have permission to read records in this data source? Se non è impostato dall'origine dati, restituisce true.If not set by the data source, returns true.

SintassiSyntax

DataSourceInfo( OrigineDati, Informazioni, NomeColonna )DataSourceInfo( DataSource, Information, ColumnName )

  • OrigineDati: obbligatorio.DataSource – Required. L'origine dati da usare.The data source to use.
  • Informazioni: obbligatorio.Information – Required. Il tipo di informazioni che si vuole recuperare.The type of information that you want to retrieve.
  • ColumnName: facoltativo.ColumnName – Optional. Per informazioni a livello di colonna, il nome della colonna come stringa.For column-level information, the column name as a string. La colonna Phone verrebbe passata come "Phone", incluse le virgolette doppie.Column Phone would be passed as "Phone", including the double quotes. Per informazioni a livello di origine dati, non può essere usato l'argomento NomeColonna.For information at the data-source level, the ColumnName argument can't be used.

    Nota: per origini dati SharePoint ed Excel che contengono nomi di colonna con spazi, specificare ogni spazio come "_x0020_".Note: For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". Ad esempio, specificare "Nome colonna" come "Column_x0020_Name".For example, specify "Column Name" as "Column_x0020_Name".

EsempiExamples

Gli esempi di questa sezione usano un'origine dati, denominata IceCream:The examples in this section use this data source, named IceCream:

L'origine dati include anche le informazioni seguenti:The data source has also provided this information:

  • Il nome visualizzato per Quantity è "Quantity on Hand".The display name for Quantity is "Quantity on Hand".
  • La lunghezza massima di Flavor è di 30 caratteri.The maximum length of Flavor is 30 characters.
  • La colonna Flavor deve contenere un valore.The Flavor column must contain a value. La colonna Quantity non è obbligatoria.The Quantity column isn't required.
  • Il valore minimo di Quantity è 0.The minimum Quantity is 0.
  • Il valore massimo di Quantity è 100.The maximum Quantity is 100.
  • L'utente corrente può leggere e modificare i record dell'origine dati IceCream, ma non può creare o eliminare record.The current user can read and edit the records of the IceCream data source but can't create or delete records.
FormulaFormula DescrizioneDescription RisultatoResult
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Restituisce il nome visualizzato per la colonna Quantity dell'origine dati IceCream.Returns the display name for the Quantity column of the IceCream data source. "Quantity on Hand""Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Restituisce la lunghezza massima della stringa per la colonna Flavor dell'origine dati IceCream.Returns the maximum length of the string for the Flavor column of the IceCream data source. 3030
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) La colonna Flavor dell'origine dati IceCream è obbligatoria?Is the Flavor column of the IceCream data source required? truetrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) La colonna Quantity dell'origine dati IceCream è obbligatoria?Is the Quantity column of the IceCream data source required? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Restituisce il valore numerico massimo per la colonna Quantity dell'origine dati IceCream.Returns the maximum numeric value for the Quantity column of the IceCream data source. 100100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Restituisce il valore numerico minimo per la colonna Quantity dell'origine dati IceCream.Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) L'utente corrente può leggere record nell'origine dati IceCream?Can the current user read records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) L'utente corrente può modificare record nell'origine dati IceCream?Can the current user edit records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) L'utente corrente può creare record nell'origine dati IceCream?Can the current user create records in the IceCream data source? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) L'utente corrente può eliminare record nell'origine dati IceCream?Can the current user delete records in the IceCream data source? falsefalse