PowerApps'teki DataSourceInfo işleviDataSourceInfo function in PowerApps

Bir veri kaynağı hakkında bilgi döndürür.Provides information about a data source.

Genel BakışOverview

Veri kaynakları, kullanıcı deneyimini iyileştirmek için zengin ölçüde bilgi sağlayabilir.Data sources can provide a wealth of information to optimize the user experience.

Patch işlevini kullanmadan önce kullanıcı girişini doğrulamak ve kullanıcıya anında geri bildirim sağlamak için sütun düzeyinde bilgileri kullanabilirsiniz.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. Validate işlevi bu bilgilerin aynısını kullanır.The Validate function uses this same information.

Örneğin, kayıtları düzenleme ve oluşturma izni olmayan kullanıcılar için Düzenle ve Yeni düğmelerini devre dışı bırakmak veya gizlemek için veri kaynağı düzeyinde bilgileri kullanabilirsiniz.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.

Veri kaynakları, sağladıkları bilgi miktarı açısından değişiklik gösterir. Hiç veri sağlamayan veri kaynakları da mevcuttur.Data sources vary in how much information they provide, including not providing any at all. Koleksiyonlar veri kaynağı herhangi bir bilgi sağlamaz.Collections provide no information. Bir bilgi sağlanmadıysa varsayılan kullanılır veya boş değer döndürülür.If a piece of information isn't provided, a default is used, or blank is returned.

AçıklamaDescription

Sütun bilgileriColumn information

Bir veri kaynağının belirli bir sütunuyla ilgili bilgileri almak için DataSourceInfo'yu kullanabilirsiniz:You can use DataSourceInfo to obtain information about a particular column of a data source:

Bilgi Bağımsız DeğişkeniInformation Argument Sonuç TürüResult Type AçıklamaDescription
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName DizeString Sütunun görünen adı.Display name for the column. Bir görünen ad tanımlanmadıysa sütun adını döndürür.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength SayıNumber Sütunun içerebileceği maksimum karakter sayısı.Maximum number of characters that the column can hold. Yalnızca dize içeren sütunlar için geçerlidir.Applies only to columns that contain strings. Maksimum değer ayarlanmadıysa boş değer döndürülür.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue SayıNumber Bir sütunun içerebileceği maksimum sayısal değer.Maximum numeric value that a column can hold. Yalnızca sayı içeren sütunlar için geçerlidir.Applies only to columns that contain numbers. Maksimum değer ayarlanmadıysa boş değer döndürülür.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue SayıNumber Bir sütunun içerebileceği minimum sayısal değer.Minimum numeric value that a column can hold. Yalnızca sayı içeren sütunlar için geçerlidir.Applies only to columns that contain numbers. Minimum değer ayarlanmadıysa boş değer döndürülür.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required BooleBoolean Bu sütun için bir değer gerekir mi?Is a value required for this column? Veri kaynağı tarafından ayarlanmadıysa false değerini döndürür.If not set by the data source, returns false.

Üçüncü bağımsız değişken bir sütunun dize olarak adıdır.The third argument is the name of a column as a string. Örneğin, People koleksiyonundaki Phone sütunu, çift tırnak işaretleri ile birlikte "Phone" olarak geçirilir.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

Veri kaynağı bilgileriData-source information

Bir veri kaynağının bilgilerini bütün olarak almak için DataSourceInfo öğesini de kullanabilirsiniz:You can also use DataSourceInfo to obtain information about a data source as a whole:

Bilgi Bağımsız DeğişkeniInformation Argument Sonuç TürüResult Type AçıklamaDescription
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues BooleBoolean Kullanıcılara bu veri kaynağı için hangi tür izinler verilebilir?What types of permissions can users be granted for this data source? Veri kaynağı tarafından ayarlanmadıysa boş değer döndürür.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission BooleBoolean Geçerli kullanıcının bu veri kaynağında kayıt oluşturma izni var mı?Does the current user have permission to create records in this data source? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission BooleBoolean Geçerli kullanıcının bu veri kaynağındaki kayıtları silme izni var mı?Does the current user have permission to delete records in this data source? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission BooleBoolean Geçerli kullanıcının bu veri kaynağındaki kayıtları düzenleme izni var mı?Does the current user have permission to edit records in this data source? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission BooleBoolean Geçerli kullanıcının bu veri kaynağındaki kayıtları okuma izni var mı?Does the current user have permission to read records in this data source? Veri kaynağı tarafından ayarlanmadıysa true değerini döndürür.If not set by the data source, returns true.

Söz dizimiSyntax

DataSourceInfo( VeriKaynağı, Bilgi, SütunAdı )DataSourceInfo( DataSource, Information, ColumnName )

  • VeriKaynağı: Gerekli.DataSource – Required. Kullanılacak veri kaynağı.The data source to use.
  • Bilgi: Gerekli.Information – Required. Almak istediğiniz bilgi türü.The type of information that you want to retrieve.
  • SütunAdı: İsteğe bağlı.ColumnName – Optional. Sütun düzeyinde bilgi için, dize olarak sütun adı.For column-level information, the column name as a string. Phone sütunu, çift tırnak işaretleri ile birlikte "Phone" olarak geçirilir.Column Phone would be passed as "Phone", including the double quotes. Veri kaynağı düzeyinde bilgi için SütunAdı bağımsız değişkeni kullanılamaz.For information at the data-source level, the ColumnName argument can't be used.

    Not

    Boşluklu sütun adları içeren SharePoint ve Excel veri kaynakları için her bir boşluğu "_x0020_" olarak belirtin.For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". Örneğin, "Sütun Adı" öğesini "Sütun_x0020_Adı" olarak belirtin.For example, specify "Column Name" as "Column_x0020_Name".

ÖrneklerExamples

Bu bölümdeki örneklerde IceCream adlı bu veri kaynağı kullanılmıştır:The examples in this section use this data source, named IceCream:

Veri kaynağı şu bilgileri de sağlamaktadır:The data source has also provided this information:

  • Quantity için görünen ad, "Quantity on Hand"dir.The display name for Quantity is "Quantity on Hand".
  • Flavor için maksimum uzunluk 30 karakterdir.The maximum length of Flavor is 30 characters.
  • Flavor sütunu bir değer içermelidir.The Flavor column must contain a value. Quantity sütunu gerekli değildir.The Quantity column isn't required.
  • Minimum Quantity değeri 0'dır.The minimum Quantity is 0.
  • Maksimum Quantity değeri 100'dür.The maximum Quantity is 100.
  • Geçerli kullanıcı, IceCream veri kaynağının kayıtlarını okuyabilir ve düzenleyebilir ancak kayıt oluşturamaz veya silemez.The current user can read and edit the records of the IceCream data source but can't create or delete records.
FormülFormula AçıklamaDescription SonuçResult
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) IceCream veri kaynağının Quantity sütunu için görünen adı döndürür.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" ) IceCream veri kaynağının Flavor sütunu için maksimum dize uzunluğunu döndürür.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" ) IceCream veri kaynağının Flavor sütunu gerekli midir?Is the Flavor column of the IceCream data source required? truetrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) IceCream veri kaynağının Quantity sütunu gerekli midir?Is the Quantity column of the IceCream data source required? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) IceCream veri kaynağının Quantity sütunu için maksimum sayısal değeri döndürür.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" ) IceCream veri kaynağının Quantity sütunu için minimum sayısal değeri döndürür.Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları okuyabilir mi?Can the current user read records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları düzenleyebilir mi?Can the current user edit records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Geçerli kullanıcı, IceCream veri kaynağında kayıt oluşturabilir mi?Can the current user create records in the IceCream data source? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Geçerli kullanıcı, IceCream veri kaynağındaki kayıtları silebilir mi?Can the current user delete records in the IceCream data source? falsefalse