HotXLS Belgeleri

SaveAs yöntem

Saves changes to the Workbook in a different file or stream. Döndürür 1 if it succeeds

Sözdizimi

function SaveAs(FileName: WideString): Integer;
function SaveAs(FileName: WideString; FileFormat: TXLSFileFormat): Integer;
function SaveAs(Stream: TStream);
function SaveAs(Stream: TStream; FileFormat: TXLSFileFormat): Integer;
FileName WideString. Kaydedilecek dosyanın adını belirten string. Tam yol içerebilir; içermiyorsa Workbook dosyayı geçerli klasöre kaydeder
FileFormat TXLSFileFormat İsteğe bağlı. Kaydedilecek dosyanın biçimini belirten değer. Varsayılan xlExcel97
Stream TStream. Saves Workbook to a stream specified in the Stream parameter

Açıklama

XLS dosya çıktısı, hedefi değiştirmeden önce serileştirmeyi bir yanda hazırlama dosyasında tamamlar; başarısız bir commit mevcut hedefi olduğu gibi bırakır ve yakalanan yerel hatayı çalışma kitabı tanılamalarıyla bildirir

POSIX rename destekleyen Windows dosya sistemlerinde, silinmeye izin veren bir meta veri veya okuyucu tanıtıcısı hâlâ açıkken değiştirme başarılı olabilir; mevcut bir okuyucu özgün dosya nesnesini görmeye devam ederken hedef adının yeni bir okuyucusu tamamlanmış değiştirmeyi görür

Hedef, silme erişimine ve silme paylaşımına izin vermelidir ve salt okunur hedefler yine reddedilir; başarısız bir commit yeniden denenmezken eksik hedefler, reparse yolları ve desteklenmeyen dosya sistemleri, değiştirmeden önce seçilen geleneksel commit yolunu kullanır

Atomik değiştirme, tek bir tamamlanmış dosyanın yayımlanmasını korur; aynı adı eşzamanlı olarak değiştiren başka bir sürece karşı karşılaştır-ve-takas izolasyonu sağlamaz

FileFormat can be one of these TXLSFileFormat constants
xlExcel97 MS Excel 97,2000,XP,2003 file format
xlExcel5 MS Excel 5,95 file format
xlHTML HTML file format
xlRTF Rich Text Format (RTF)
xlCSV Comma separated values file format (CSV)
xlText Tab separated values file format (TSV)
xlUnicodeCSV Comma separated unicode values file format (CSV)
xlUnicodeText Tab separated unicode values file format (TSV)

Örnek

Bu örnek, tek çalışma sayfalı yeni bir çalışma kitabı oluşturur ve ardından çalışma kitabını kaydeder

Var
  Workbook: IXLSWorkbook;
begin
  Workbook := TXLSWorkbook.Create; {create new Workbook}
  Workbook.Worksheets.Add;
  {...}
  //Save Workbook as Excel 97 file format 
  Workbook.SaveAs('C:\book.xls');
  //Save Workbook as Excel 5-95 file format 
  Workbook.SaveAs('C:\book5.xls', xlExcel5);
  //Save Workbook as HTML 
  Workbook.SaveAs('C:\book.html', xlHTML);
  //Save Workbook as RTF file 
  Workbook.SaveAs('C:\book.rtf', xlRTF);
  //Save active Worksheet as comma separated values (CSV)
  Workbook.SaveAs('C:\book.csv', xlCSV);
  //Save active Worksheet as tab separated values (TSV)
  Workbook.SaveAs('C:\book.tsv', xlText);
  //Save active Worksheet as comma separated unicode values (CSV)
  Workbook.SaveAs('C:\book.csv', xlUnicodeCSV);
  //Save active Worksheet as tab separated unicode values (TSV)
  Workbook.SaveAs('C:\book.tsv', xlUnicodeText);
end;
This example saves Workbook into the BLOB field

var
  MS: TMemoryStream;
begin
  if not (ClientDataSet1.State in [dsInsert, dsEdit]) then
    ClientDataSet1.Insert;
  MS := TMemoryStream.Create();
  try
    FWorkbook.SaveAs(MS);
    ClientDataSet1Documents.LoadFromStream(MS);
  finally
    MS.Free;
  end;
  ClientDataSet1.Post;
end;