Power Apps 'teki Collect, Clear ve ClearCollect işlevleriCollect, Clear, and ClearCollect functions in Power Apps

Koleksiyonlar oluşturup temizler ve herhangi bir veri kaynağına kayıtlar ekler.Creates and clears collections and adds records to any data source.

AçıklamaDescription

CollectCollect

Collect işlevi bir veri kaynağına kayıtlar ekler.The Collect function adds records to a data source. Eklenecek öğeler şunlar olabilir:The items to be added can be:

  • Tek bir değer: Değer, yeni bir kaydın Value alanına yerleştirilir.A single value: The value is placed in the Value field of a new record. Diğer tüm özellikler boş bırakılır.All other properties are left blank.
  • Kayıt: Her bir adlandırılmış özellik, yeni bir kaydın karşılık gelen özelliğine yerleştirilir.A record: Each named property is placed in the corresponding property of a new record. Diğer tüm özellikler boş bırakılır.All other properties are left blank.
  • Tablo: Tablonun her kaydı, yukarıda açıklandığı gibi veri kaynağının ayrı bir kaydı olarak eklenir.A table: Each record of the table is added as a separate record of the data source as described above. Tablo bir kayda iç içe geçmiş tablo olarak eklenmez.The table is not added as a nested table to a record. Bunu gerçekleştirmek için önce bir kayıttaki tabloyu kaydırın.To accomplish this, wrap the table in a record first.

Koleksiyonla kullanıldığında, gerektiği şekilde ek sütunlar oluşturulur.When used with a collection, additional columns will be created as needed. Diğer veri kaynakları için sütunlar, veri kaynağı tarafından düzeltilir ve yeni sütunlar eklenemez.The columns for other data sources are fixed by the data source and new columns cannot be added.

Veri kaynağı yoksa bir koleksiyon oluşturulur.If the data source doesn't already exist, a collection is created.

Koleksiyonlar bazen genel değişkenleri tutmak veya bir veri kaynağının geçici kopyasını oluşturmak için kullanılır.Collections are sometimes used to hold global variables or make a temporary copy of a data source. Power Apps, Kullanıcı bir uygulamayla etkileşime geçtiğinde otomatik olarak yeniden hesaplama yapan formülleri temel alır.Power Apps are based on formulas that automatically recalculate as the user interacts with an app. Koleksiyonlar bu avantaja sahip değildir ve bunların kullanılması, uygulamanızın oluşturulmasını ve anlaşılmasını zorlaştırabilir.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Bir koleksiyonu bu şekilde kullanmadan önce değişkenlerle çalışma bölümünü gözden geçirin.Before using a collection in this manner, review working with variables.

Ayrıca bir veri kaynağında kayıtlar oluşturmak için Patch işlevini de kullanabilirsiniz.You can also use the Patch function to create records in a data source.

Collect, değiştirilen veri kaynağını tablo olarak döndürür.Collect returns the modified data source as a table. Collect yalnızca bir davranış formülünde kullanılabilir.Collect can only be used in a behavior formula.

ClearClear

Clear işlevi bir koleksiyonun tüm kayıtlarını siler.The Clear function deletes all the records of a collection. Koleksiyonun sütunları kalır.The columns of the collection will remain.

Clear işlevinin yalnızca koleksiyonlarda çalıştığını ve diğer veri kaynaklarında çalışmadığını unutmayın.Note that Clear only operates on collections and not other data sources. Bunun için RemoveIf( VeriKaynağı; true ) söz dizimini kullanabilirsiniz.You can use RemoveIf( DataSource; true ) for this purpose. Veri kaynağının depolama alanındaki tüm kayıtlar kaldırılacağından ve diğer kullanıcılar etkilenebileceğinden bu işlem konusunda dikkatli olun.Use caution as this will remove all records from the data source's storage and can affect other users.

Kayıtları seçerek kaldırmak için Remove işlevini kullanabilirsiniz.You can use the Remove function to selectively remove records.

Clear bir değer döndürmez.Clear has no return value. Yalnızca bir davranış formülünde kullanılabilir.It can only be used in a behavior formula.

ClearCollectClearCollect

ClearCollect işlevi bir koleksiyondaki tüm kayıtları siler ve aynı koleksiyona farklı bir kayıt kümesi ekler.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. ClearCollect tek bir işlevle Clear ve Collect işlevlerinin birleşimini sunar.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect, değiştirilen koleksiyonu tablo olarak döndürür.ClearCollect returns the modified collection as a table. ClearCollect yalnızca bir davranış formülünde kullanılabilir.ClearCollect can only be used in a behavior formula.

Söz DizimiSyntax

Collect( VeriKaynağı; Öğe; ... )Collect( DataSource; Item; ... )

  • VeriKaynağı: Gerekli.DataSource – Required. Veri eklemek istediğiniz veri kaynağı.The data source that you want to add data to. Yoksa yeni bir koleksiyon oluşturulur.If it does not already exist, a new collection is created.
  • Öğeler: Gerekli.Item(s) - Required. Veri kaynağına eklenecek bir veya daha fazla kayıt ya da tablo.One or more records or tables to add to the data source.

Clear( Koleksiyon )Clear( Collection )

  • Koleksiyon: Gerekli.Collection – Required. Temizlemek istediğiniz koleksiyon.The collection that you want to clear.

ClearCollect( Koleksiyon; Öğe; ... )ClearCollect( Collection; Item; ... )

  • Koleksiyon: Gerekli.Collection – Required. Temizleyip veri eklemek istediğiniz koleksiyon.The collection that you want to clear and then add data to.
  • Öğeler: Gerekli.Item(s) - Required. Veri kaynağına eklenecek bir veya daha fazla kayıt ya da tablo.One or more records or tables to add to the data source.

ÖrneklerExamples

Veri kaynağını temizleme ve veri kaynağına kayıt eklemeClearing and adding records to a data source

Bu örneklerde, IceCream adlı bir koleksiyonu silip bu koleksiyona kayıt ekleyeceksiniz yapacaksınız.In these examples, you'll erase and add to a collection that's named IceCream. Veri kaynağı şu içeriklerle başlar:The data source begins with these contents:

Örnek veri kaynağı

FormülFormula AçıklamaDescription SonuçResult
ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } )ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } ) IceCream koleksiyonundaki tüm verileri temizler ve ardından, bir miktar çilekli dondurma içeren bir kayıt ekler.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream.
| Collect( IceCream; { Flavor: "Pistachio"; Quantity: 40 }; { Flavor: "Orange"; Quantity: 200 } )Collect( IceCream; { Flavor: "Pistachio"; Quantity: 40 }; { Flavor: "Orange"; Quantity: 200 } ) |Icecream koleksiyonuna, Pistachio ve turuncu buz içeren bir miktar dahil olmak üzere iki kayıt ekler.Adds two records to the IceCream collection that includes a quantity of pistachio and orange ice cream. |iki kayıtla tabloTable with two records

Icecream koleksiyonu da değiştirilmiştir.The IceCream collection has also been modified. |
bir kayıt](media/function-clear-collect-clearcollect/icecream-clearcollect.png) tablo  img { max-width: none }  Table with one recordIcecream koleksiyonu da değiştirilmiştir.The IceCream collection has also been modified. || Clear( IceCream )Clear( IceCream ) |IceCream koleksiyonundaki tüm kayıtları kaldırır.Removes all records from the IceCream collection. |Boş tablo ![Empty table

Icecream koleksiyonu da değiştirilmiştir.The IceCream collection has also been modified.

Koleksiyon oluşturma hakkında adım adım örnekler için bkz. koleksiyon oluşturma ve güncelleştirme.For step-by-step examples of how to create a collection, see Create and update a collection.

Kayıtlar ve tablolarRecords and tables

Bu örneklerde, toplama ve clearcollect için kayıt ve tablo bağımsız değişkenlerinin nasıl işlendiği incelenmelidir.These examples examine how record and table arguments to Collect and ClearCollect are handled.

FormülFormula AçıklamaDescription SonuçResult
ClearCollect (Icecream; { Flavor: "çikolata"; miktar: 100 }; { Flavor: "Vanilla"; Quantity: 200 })ClearCollect( IceCream; { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) Tüm verileri temizleyin ve ardından Icecream koleksiyonuna iki kayıt ekler ve bu da bir çikolata ve Vanilla buz kremi içeren bir miktar içerir.Clear all data and then adds two records to the IceCream collection that includes a quantity of chocolate and vanilla ice cream. Eklenecek kayıtlar, işleve bağımsız bağımsız değişkenler olarak sağlanır.The records to be added are provided as individual arguments to the function. çikolata ve Vanilla kayıtları koleksiyona eklendiChocolate and Vanilla records added to collection

Icecream koleksiyonu da değiştirilmiştir.The IceCream collection has also been modified.
ClearCollect (Icecream; Table ({ Flavor: "çikolata"; miktarı: 100 }; { Flavor: "Vanilla"; Quantity: 200 }))ClearCollect( IceCream; Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) ) Kayıtların bir tabloda birleştirilmesi ve tek bir bağımsız değişken aracılığıyla geçirilmesi dışında önceki örnekle aynıdır.Same as the previous example except that the records are combined in a table and passed in through a single argument. Tablonun içeriği, Icecream koleksiyonuna eklenmeden önce kaydı kayıt tarafından ayıklanır.The contents of the table are extracted record by record before being added to the IceCream collection. çikolata ve Vanilla kayıtları koleksiyona eklendiChocolate and Vanilla records added to collection

Icecream koleksiyonu da değiştirilmiştir.The IceCream collection has also been modified.
ClearCollect (Icecream;
{ MyFavorites: Table ({ Flavor: "çikolata"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 })})
ClearCollect( IceCream;
{ MyFavorites: Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) } )
Tablonun bir kayıtta sarmalanması dışında, önceki örnekle aynıdır.Same as the previous example except that the table is wrapped in a record. Tablonun kayıtları ayıklanmaz ve bunun yerine tablonun tamamı kaydın alt tablosu olarak eklenir.The records of the table are not extracted and instead the entire table is added as a sub-table of the record. çikolata ve Vanilla kayıtları koleksiyona eklendiChocolate and Vanilla records added to collection

Icecream koleksiyonu da değiştirilmiştir.The IceCream collection has also been modified.