Validate işlevi
Şunlar için geçerlidir: Tuval uygulamaları Model temelli uygulamalar
Validate işlevi tek bir sütunun veya bir kaydın tamamının değerinin bir veri kaynağı için geçerli olup olmadığını kontrol eder.
Açıklama
Bir kullanıcı tarafından veri değişikliği gönderilmeden önce ilgili gönderinin geçerli olup olmadığıyla ilgili anlık geri bildirim sağlayarak daha iyi bir kullanıcı deneyimi oluşturabilirsiniz.
Veri kaynakları bir kayıtta geçerli değer olarak kabul edilen veriler hakkında bilgi sağlayabilir. Bu bilgiler aşağıdaki örnekte olduğu gibi birçok kısıtlama içerebilir:
- bir sütun için değer gerekip gerekmediği
- bir metin dizesinin ne kadar uzun olabileceği
- sayıların alt ve üst sınırları
- tarihlerin başlangıç ve bitiş dönemleri
Validate işlevi bu bilgileri kullanarak bir değerin geçerli olup olmadığını belirler ve geçerli olmaması halinde uygun bir hata iletisi döndürür. DataSourceInfo işlevini kullanarak Validate tarafından kullanılan bilgilerin aynısını görüntüleyebilirsiniz.
Veri kaynakları, sağladıkları bilgi miktarı açısından değişiklik gösterir. Hiç veri sağlamayan veri kaynakları da mevcuttur. Validate işlevi, değerleri yalnızca bu bilgilere dayanarak doğrulayabilir. Validate bir sorun algılamasa da veri değişikliğinin uygulanması hata oluşturabilir. Errors işlevini kullanarak hatayla ilgili bilgi alabilirsiniz.
Validate işlevi bir sorun algılarsa uygulamanın kullanıcılarına gösterebileceğiniz bir hata iletisi döndürür. Tüm değerler geçerliyse Validate işlevi blank değer döndürür. Doğrulama bilgisine sahip olmayan bir koleksiyonla çalıştığınızda değerler her zaman geçerlidir.
Sözdizimi
Validate( DataSource, Sütun, Değer )
- DataSource – Gerekli. Doğrulama yapılacak veri kaynağı.
- Sütun: Gerekli. Doğrulanacak sütun.
- Değer: Gerekli. Seçilen sütunun doğrulanması için gerekli değer.
Validate( DataSource, OriginalRecord, Güncelleştirmeler )
- DataSource – Gerekli. Doğrulama yapılacak veri kaynağı.
- OriginalRecord: Gerekli. Güncelleştirmelerin doğrulanacağı kayıt.
- Güncelleştirmeler: Gerekli. Özgün kayda uygulanacak değişiklikler.
Örnekler
Bu örnekler için Puanlar veri kaynağının Yüzde sütunundaki değerlerin 0 ile 100 arasında (ikisi de dahil) olması gerekir. Veriler doğrulamadan geçerse işlev boş değer döndürür. Geçemezse işlev bir hata iletisi döndürür.
Tek bir sütunla doğrulama
Formül | Açıklama | Sonuç |
---|---|---|
Validate( Puanlar, Yüzde, 10 ) | 10 değerinin Puanlar veri kaynağındaki Yüzde sütunu için geçerli bir değer olup olmadığını kontrol eder. | blank |
Validate( Puanlar, Yüzde, 120 ) | 120 değerinin Puanlar veri kaynağındaki Yüzde sütunu için geçerli bir değer olup olmadığını kontrol eder. | "Değerler 0 ile 100 arasında olmalıdır." |
Tam bir kayıtla doğrulama
Formül | Açıklama | Sonuç |
---|---|---|
Validate( Puanlar, EditRecord, Gallery.Updates ) | Tüm sütunlardaki verilerin Puanlar veri kaynağı için geçerli olup olmadığını denetler. Bu örnekte, Yüzde sütununda 10 değeri bulunmaktadır. | blank |
Validate( Puanlar, EditRecord, Gallery.Updates ) | Tüm sütunlardaki verilerin Puanlar veri kaynağı için geçerli olup olmadığını denetler. Bu örnekte, Yüzde sütununda 120 değeri bulunmaktadır. | "Değerler 0 ile 100 arasında olmalıdır." |
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin