Ana içeriğe geç

FileList

FileList, dosya başvurularından oluşan bir koleksiyonu tek bir form alanına bağlar. Kullanıcıların ayrı bir tablo veya yinelenen form bölümü eklemeden birden fazla dosya eklemesi gerektiğinde kullanın. Tek bir değer için File veya ImageUpload kullanın.

XML Alanları

Alan Anlamı
XPath Koleksiyon kapsayıcısını seçer. Tek bir dosya öğesini seçmez.
ItemXPath Yinelenen dosya öğelerinin XPath'ini içeren alt öğe. Varsayılan değer File; bir XML özniteliği değildir.
MaxFiles Seçilen dosyalar için istemci tarafındaki sınır; 0 değeri, bileşen tarafından ek bir sınır uygulanmadığı anlamına gelir.
NameXPath Her dosya öğesine göre değerlendirilen isteğe bağlı dosya adı yolu. Boş bırakılırsa ilgili öğenin Caption özniteliği kullanılır.
Accept İstemci seçiminde kullanılan virgülle ayrılmış uzantılar veya MIME türleri; örneğin .pdf,image/*.
RequiredForGroup Eşleşen grup için, silinmemiş ve değeri boş olmayan en az bir dosya öğesi gerektirir; değer 0 değerinden farklı olmalıdır.

FileList, File bileşeninin şablon veri kaynaklarını, ipuçlarını, kurallarını ve düzenleme ayarlarını da devralır. Accept ve MaxFiles istemci denetimleridir; gerektiğinde iş koluna özgü kısıtlamaları sunucuda uygulayın. Sunucunun dosya politikası ve izinleri bağımsız olarak geçerlidir.

1
2
3
<FileList XPath="Attachments" MaxFiles="5" Accept=".pdf,image/*" RequiredForGroup="Save">
    <ItemXPath><![CDATA[File]]></ItemXPath>
</FileList>

Veri Modeli

Kapsayıcı, yinelenen forms:File öğeler barındırır. Her öğe, File alanıyla aynı skaler gösterimi kullanır: metni dosya kimliğidir; dosya adı, URL ve revizyon öznitelikleri bu öğede bulunur.

1
2
3
4
<Attachments>
    <File Caption="Proposal.pdf">11111111-1111-4111-8111-111111111111</File>
    <File Caption="Drawing.png">22222222-2222-4222-8222-222222222222</File>
</Attachments>

Değiştirme sırasında öğenin kurallı dosya kimliği korunabilir ve yeni yüklemenin kimliği öğenin Revision özniteliğinde saklanabilir. Her öğenin kendi revizyon durumu vardır. Bir öğenin değiştirilmesi koleksiyonu değiştirmez veya diğer dosya öğelerini etkilemez.

Özel bir öğe adı kullanmak için hem veri modelindeki yinelenen öğeyi hem de ItemXPathdeğerini değiştirin. NameXPath öğeye göreli kalmalıdır; skaler File alanından farklı olarak öğenin üst öğesine göre değerlendirilmez.

Tasarımcı ve Çalışma Zamanı Davranışı

Tasarımcı aracılığıyla FileList oluşturulduğunda, seçilen öğe adı kullanılarak bir koleksiyon kapsayıcısı ve yinelenen bir forms:File alt öğe oluşturulur. Mevcut uyumlu karmaşık alan, yinelenen bir dosya alt öğesi içermelidir. Skaler dosya alanı, FileList koleksiyonu değildir.

Kompakt form denetimi dosya sayısını gösterir. Seçildiğinde ek listesi açılır. Seçim penceresi toplu seçimi ve Seçili Dosyaları Ekleişlemini destekler; tek bir öğeyi değiştirme işlemi yine tek dosyayla sınırlıdır. Mevcut seçimler MaxFiles.

sınırına dahildir. Multiple, ItemXPathFile ve ImageUpload skaler bileşenler olarak kalır. Koleksiyon oluşturmak için tanımlarına MaxFiles veya