Aracılığıyla paylaş


InstallFiles Eylemi

InstallFiles eylemi, Dosya tablosunda belirtilen dosyaları kaynak dizinden hedef dizine kopyalar.

Sıra Kısıtlamaları

InstallFiles eylemi, InstallValidate eyleminden sonra ve dosyaya bağımlı eylemlerden önce gelmelidir.

ActionData İletileri

Alan Eylem verilerinin açıklaması
[1] Yüklü dosyanın tanımlayıcısı.
[6] Yüklü dosyanın bayt cinsinden boyutu.
[9] Yüklü dosyayı tutan dizin tanımlayıcısı.

 

Açıklamalar

InstallFiles eylemi, Dosya tablosunda belirtilen dosyalarda çalışır. Her dosya, Bileşeni tablosundaki dosyanın ilişkili bileşeninin yükleme durumuna göre yüklenir. Yalnızca bileşenleri msiInstallStatelocal durumuna çözümlenen dosyalar kopyalamaya uygundur.

InstallFiles eylemi, Dosya tablosunun aşağıdaki sütunlarını uygular.

  • FileName sütunu hedef dosya adını belirtir.
  • Sürüm sütunu dosya sürümünü belirtir.
  • Öznitelikler sütunu, dosya ve yükleme özniteliği bayrak bitlerini belirtir.
  • Dosya sütunu benzersiz dosya belirtecini belirtir.
  • FileSize sütunu sıkıştırılmamış dosya boyutunu bayt cinsinden belirtir.
  • Dil sütunu, dosya dili tanımlayıcısını belirtir.
  • Sıra sütunu, medyadaki sıra numarasını belirtir.

InstallFiles eylemi, Bileşen tablosunun aşağıdaki sütunlarını uygular.

  • Directory_ sütunu, Directory tablosu öğesine başvuru belirtir.
  • Bileşen sütunu, bileşen öğesi için benzersiz bir ad belirtir.

Belirtilen dosya yalnızca aşağıdakilerden biri doğruysa kopyalanır:

  • Dosya şu anda yerel bilgisayarda yüklü değil.
  • Dosya yerel bilgisayardadır, ancak Dosya tablosundakidosyadan daha düşük bir sürüm numarasına sahiptir.
  • Dosya yerel bilgisayarda, ancak ilişkili sürüm numarası yok.

Kopyalanacak her dosyanın kaynak dizini sourceMode tarafından belirlenir ve bu da Media tablosunun Cabinet sütunundaki değere bağlıdır. Kaynak modu hakkında tam bir tartışma için Media tablosuna bakın.

Kopyalanacak dosyanın kaynak dizini disket veya CD-ROM gibi çıkarılabilir medyada bulunuyorsa, InstallFiles eylemi dosyayı kopyalamaya çalışmadan önce uygun kaynak medyanın eklendiğini doğrular. InstallFiles, Media tablosunun VolumeLabel sütununda verilen değerle eşleşen bir birim etiketiyle aynı çıkarılabilir türdeki medyayı arar. Eşleşen bir bağlı birim bulunursa, dosya kopyalama işlemi devam eder. Eşleşme bulunmazsa, bir iletişim kutusu kullanıcının uygun medyayı eklemesini istemektedir. Bu durumda iletişim kutusu, istemin bir parçası olarak Media tablosunun DiskPrompt sütununda bulunan medya adını kullanır.

InstallFiles eylemi özgün bir dosyayı silip değiştiremediğinden dikkatli olunmalıdır. Bu durum, InstallFiles eylemi eski bir dosyayı değiştirirken bir hatayla karşılaştığında ve kullanıcı hatayı yoksaymayı seçtiğinde oluşur. Yükleyicinin varsayılan davranışı, yeni dosyanın doğru kopyalandığından emin olmadan önce eski bir dosyayı silmektir.

Yükleyici tarafından kullanılan dosya sürüm oluşturma kuralları için bkz. Dosya Sürüm Oluşturma Kuralları.