PowerApps'teki Ekler denetimiAttachments control in PowerApps

Kullanıcıların cihazlara dosya indirmesini ve bir SharePoint listesindeki veya Common Data Service varlığındaki dosyaları karşıya yükleme ve silme olanağı tanıyan bir denetimdir.A control that allows users to download files to their device, as well as upload and delete files from a SharePoint list or a Common Data Service entity.

AlgılanLimitations

Ek denetimi için aşağıdaki sınırlamalar bulunmaktadır:The attachment control has these limitations:

  1. Ekler, SharePoint listeleri ve Common Data Service varlıkları ile desteklenir.Attachments are supported with SharePoint lists and Common Data Service entities.

  2. İşlevselliği karşıya yükle ve Sil işlevi yalnızca bir form içinde çalışır.Upload and delete functionality work only inside a form. Ek denetimi, form içinde değil, düzenleme modundayken devre dışı görünür.The Attachment control appears disabled when in Edit mode and not inside a form. Dosya eklemeleri ve silmeleri kaydetmek için, uygulama kullanıcısının formu kaydetmesi gerekir.To save file additions and deletions, the app user must save the form. Bu sınırlama nedeniyle, ek denetimi Ekle sekmesinden kullanılamaz, ancak ek formu alanı bir SharePoint veya Common Data Service formunda etkinleştirildiğinde formda görüntülenir.Because of this limitation, the Attachment control isn't available from the Insert tab but appears in the form when the Attachment form field is enabled in a SharePoint or Common Data Service form.

  3. Dosyaları yalnızca 10 MB veya daha küçükse karşıya yükleyebilirsiniz.You can upload files only if they're 10 MB or smaller.

AçıklamaDescription

Ekler denetimi bir SharePoint listesinden veya Common Data Service varlığından dosya açmanıza, eklemenize ve silmenize olanak sağlar.An Attachments control lets you open, add, and delete files from a SharePoint list or a Common Data Service entity.

Temel özelliklerKey properties

Items : indirilebilir dosyaları tanımlayan kaynak.Items – The source describing the files that can be downloaded.

MaxAttachments: denetimin kabul edeceği maksimum dosya sayısı.MaxAttachments – The maximum number of files the control will accept.

MaxAttachmentSize: her yeni ek için MB cinsinden izin verilen maksimum dosya boyutu.MaxAttachmentSize – The maximum allowed file size in MB of each new attachment. Şu anda 10 MB'lık bir sınır bulunmaktadır.Currently there is a limit of 10 MB.

OnAttach: kullanıcı yeni bir dosya eki eklediğinde uygulamanın nasıl yanıt verdiği.OnAttach – How the app responds when the user adds a new file attachment.

OnRemove: kullanıcı mevcut bir eki sildiğinde uygulamanın nasıl yanıt verdiği.OnRemove – How the app responds when the user deletes an existing attachment.

OnSelect : kullanıcı bir eke tıkladığında uygulamanın nasıl yanıt verdiği.OnSelect – How the app responds when the user clicks on an attachment.

Ek özelliklerAdditional properties

AccessibleLabel – Ekran okuyucular için etiket.AccessibleLabel – Label for screen readers. Eklerin amacını açıklamalıdır.Should describe the purpose of the attachments.

AddAttachmentText: yeni bir ek eklemek için kullanılan bağlantıya ilişkin etiket metni.AddAttachmentText – The label text for the link used to add a new attachment.

BorderColor : bir denetimin kenarlığının rengi.BorderColor – The color of a control's border.

BorderStyle : Düz, Kesik Çizgili, Noktalı veya Hiçbiri değerleriyle bir denetimin kenarlık stili.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness : bir denetimin kenarlık kalınlığı.BorderThickness – The thickness of a control's border.

DisplayMode : denetimin dosya eklemeye ve silmeye izin verip vermediği (Düzenle), yalnızca veri görüntüleyip görüntülemediği (View) veya devre dışı olup olmadığı (Disabled).DisplayMode – Whether the control allows adding and deleting files (Edit), only displays data (View), or is disabled (Disabled).

FocusedBorderColor – Denetim odaklandığında denetim kenarlığının rengi.FocusedBorderColor – The color of a control's border when the control is focused.

FocusedBorderThickness – Denetim odaklandığında denetim kenarlığının kalınlığı.FocusedBorderThickness – The thickness of a control's border when the control is focused.

Height : denetimin üst ve alt kenarları arasındaki uzaklık.Height – The distance between a control's top and bottom edges.

MaxAttachmentsText: denetim izin verilen maksimum sayıda dosya içerdiğinde "Dosya ekle" bağlantısının yerini alan metin.MaxAttachmentsText – The text that replaces the "Attach file" link when the control contains the maximum number of files allowed.

NoAttachmentsText: hiç dosya eklenmediğinde kullanıcıya gösterilen bilgilendirici metin.NoAttachmentsText – Informational text shown to the user when there are no files attached.

TabIndex – Diğer denetimlerle ilgili olarak klavye ile gezinme sırası.TabIndex – Keyboard navigation order in relation to other controls.

Visible : bir denetimin görünür veya gizli olması.Visible – Whether a control is visible or hidden.

Width : denetimin sol ve sağ kenarları arasındaki uzaklık.Width – The distance between a control's left and right edges.

X : bir denetimin sol kenarı ile ana kapsayıcısının (ana kapsayıcı yoksa ekranın) sol kenarı arasındaki uzaklık.X – The distance between the left edge of a control and the left edge of its parent container (or screen, if no parent container).

Y : bir denetimin üst kenarı ile ana kapsayıcısının (ana kapsayıcı yoksa ekranın) üst kenarı arasındaki uzaklık.Y – The distance between the top edge of a control and the top edge of the parent container (or screen, if no parent container).

ÖrnekExample

  1. SharePoint listesini bir veri kaynağı şeklinde kullanarak bir uygulama oluşturun.Create an app from data using a SharePoint list as a data source. Alternatif olarak, uygulamanızdan bir form ekleyin ve bir SharePoint listesini bu formun veri kaynağı olarak ayarlayın.As an alternative, add a form to your app, and set a SharePoint list as its data source.

  2. Sol taraftaki ağaç görünümünden Form denetimini seçin.Select the Form control in the tree view on the left-hand side.

  3. Sağdaki seçenekler panelinde yer alan Özellikler sekmesindeki Veriler'i tıklayın.Click Data in the Properties tab in the options panel on the right.

  4. Alanlar bölümünde Ekler alanını etkinleştirin.Under Fields, enable the Attachments field.

    SharePoint listesi ile ilişkili Ekler alanı formda görüntülenir.The Attachments field associated with the SharePoint list will appear in the form.

[Denetim ekleme ve yapılandırma hakkında bilgi edinin].(../add-configure-controls.md)[Learn how to add and configure a control].(../add-configure-controls.md)

Erişilebilirlik yönergeleriAccessibility guidelines

Renk karşıtlığıColor contrast

Şunlar arasında yeterli bir renk karşıtlığı olmalıdır:There must be adequate color contrast between:

  • ItemColor ve ItemFillItemColor and ItemFill
  • ItemHoverColor ve ItemHoverFillItemHoverColor and ItemHoverFill
  • ItemPressedColor ve ItemPressedFillItemPressedColor and ItemPressedFill
  • AddedItemColor ve AddedItemFillAddedItemColor and AddedItemFill
  • RemovedItemColor ve RemovedItemFillRemovedItemColor and RemovedItemFill
  • ItemErrorColor ve ItemErrorFillItemErrorColor and ItemErrorFill
  • AddAttachmentColor ve FillAddAttachmentColor and Fill
  • MaxAttachmentsColor ve FillMaxAttachmentsColor and Fill
  • NoAttachmentsColor ve FillNoAttachmentsColor and Fill

Bu, standart renk karşıtlığı gereksinimlerine ek niteliğindedir.This is in addition to the standard color contrast requirements.

Ekran okuyucu desteğiScreen reader support

Şu özellikler mevcut olmalıdır:The following properties must be present:

Klavye desteğiKeyboard support