HtmlSaveOptions

HtmlSaveOptions class

Bir belgeyi the ‘ye kaydederken ek seçenekleri belirtmek için kullanılabilirHtml ,Mhtml ,Epub , Azw3 veyaMobi format.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Kaydetme Seçeneklerini Belirtin dokümantasyon makalesi.

public class HtmlSaveOptions : SaveOptions

yapıcılar

İsimTanım
HtmlSaveOptions()Bu sınıfın, bir document dosyasını kaydetmek için kullanılabilecek yeni bir örneğini başlatır.Html format.
HtmlSaveOptions(SaveFormat)Bu sınıfın, bir document dosyasını kaydetmek için kullanılabilecek yeni bir örneğini başlatır.Html ,Mhtml ,Epub , Azw3 veyaMobi format.

Özellikleri

İsimTanım
AllowEmbeddingPostScriptFonts { get; set; }Kaydedildikten sonra TrueType yazı tiplerini bir belgeye gömerken PostScript ana hatlarıyla yazı tiplerinin gömülmesine izin verilip verilmeyeceğini belirten bir boole değeri alır veya ayarlar. Varsayılan değer:YANLIŞ .
AllowNegativeIndent { get; set; }HTML, MHTML veya EPUB’a kaydederken paragrafların negatif sol ve sağ girintilerinin normalize edilip edilmeyeceğini belirtir. Varsayılan değer:YANLIŞ .
CssClassNamePrefix { get; set; }Tüm CSS sınıfı adlarına eklenen bir öneki belirtir. Varsayılan değer boş bir dizedir ve oluşturulan CSS sınıfı adlarının ortak bir öneki yoktur.
CssSavingCallback { get; set; }Bir belge HTML, MHTML veya EPUB’a kaydedildiğinde CSS stillerinin nasıl kaydedileceğini kontrol etmenizi sağlar.
CssStyleSheetFileName { get; set; }Bir document HTML’ye aktarıldığında yazılan Basamaklı Stil Sayfası (CSS) dosyasının yolunu ve adını belirtir. Varsayılan, boş bir dizedir.
CssStyleSheetType { get; set; }CSS (Basamaklı Stil Sayfası) stillerinin HTML, MHTML veya EPUB’a nasıl aktarılacağını belirtir. Varsayılan değer:Inline HTML/MHTML ve içinExternal EPUB. için
CustomTimeZoneInfo { get; set; }Tarih/saat alanları için kullanılan özel yerel saat dilimini alır veya ayarlar.
DefaultTemplate { get; set; }Varsayılan şablonun yolunu alır veya ayarlar (dosya adı dahil). Bu özellik için varsayılan değer:boş dize (Empty).
Dml3DEffectsRenderingMode { get; set; }3B efektlerin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
virtual DmlEffectsRenderingMode { get; set; }DrawingML efektlerinin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
DmlRenderingMode { get; set; }DrawingML şekillerinin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
DocumentPartSavingCallback { get; set; }Bir belge HTML veya EPUB’a kaydedildiğinde belge bölümlerinin nasıl kaydedileceğini kontrol etmenizi sağlar.
DocumentSplitCriteria { get; set; }Belgeyi kaydederken nasıl bölünmesi gerektiğini belirtirHtml , Epub veyaAzw3 biçim. Varsayılan:None HTML ve içinHeadingParagraph EPUB ve AZW3. için
DocumentSplitHeadingLevel { get; set; }Belgenin bölüneceği maksimum başlık düzeyini belirtir. Varsayılan değer:2 .
Encoding { get; set; }HTML, MHTML veya EPUB’a dışa aktarırken kullanılacak kodlamayı belirtir. Varsayılan değer:yeni UTF8Kodlama(yanlış) (BOM olmadan UTF-8).
ExportCidUrlsForMhtmlResources { get; set; }MHTML belgelerinde bulunan kaynaklara (resimler, yazı tipleri, CSS) başvurmak için CID (İçerik Kimliği) URL’lerinin kullanılıp kullanılmayacağını belirtir. Varsayılan değer:YANLIŞ .
ExportDocumentProperties { get; set; }Yerleşik ve özel belge özelliklerinin HTML, MHTML veya EPUB’a aktarılıp aktarılmayacağını belirtir. Varsayılan değer:YANLIŞ .
ExportDropDownFormFieldAsText { get; set; }Açılır form alanlarının HTML veya MHTML’ye nasıl kaydedileceğini kontrol eder. Varsayılan değer:YANLIŞ .
ExportFontResources { get; set; }Yazı tipi kaynaklarının HTML’ye mi, MHTML’ye mi yoksa EPUB’a mı aktarılacağını belirtir. Varsayılan:YANLIŞ .
ExportFontsAsBase64 { get; set; }Yazı tipi kaynaklarının Base64 kodlamasında HTML’ye gömülmesi gerekip gerekmediğini belirtir. Varsayılan:YANLIŞ .
ExportGeneratorName { get; set; }Ne zamandoğru , Aspose.Words’ün adının ve sürümünün üretilen dosyalara yerleştirilmesine neden olur. Varsayılan değer:doğru .
ExportHeadersFootersMode { get; set; }Üstbilgilerin ve altbilgilerin HTML, MHTML veya EPUB’a nasıl aktarılacağını belirtir. Varsayılan değer:PerSection HTML/MHTML için veNone EPUB. için
ExportImagesAsBase64 { get; set; }Görüntülerin HTML, MHTML veya EPUB çıkışına Base64 formatında kaydedilip kaydedilmeyeceğini belirtir. Varsayılan:YANLIŞ .
ExportLanguageInformation { get; set; }Dil bilgilerinin HTML’ye mi, MHTML’ye mi yoksa EPUB’a mı aktarılacağını belirtir. Varsayılan:YANLIŞ .
ExportListLabels { get; set; }Liste etiketlerinin HTML, MHTML veya EPUB’a nasıl aktarılacağını kontrol eder. Varsayılan değer:Auto .
ExportOriginalUrlForLinkedImages { get; set; }Bağlantılı görsellerin URL’si olarak orijinal URL’nin kullanılıp kullanılmayacağını belirtir. Varsayılan değer:YANLIŞ .
ExportPageMargins { get; set; }Sayfa kenar boşluklarının HTML’ye mi, MHTML’ye mi yoksa EPUB’a mı aktarılacağını belirtir. Varsayılan:YANLIŞ .
ExportPageSetup { get; set; }Sayfa düzeninin HTML’ye mi, MHTML’ye mi yoksa EPUB’a mı aktarılacağını belirtir. Varsayılan:YANLIŞ .
ExportRelativeFontSize { get; set; }HTML, MHTML veya EPUB’a kaydederken yazı tipi boyutlarının göreli birimler halinde çıkarılıp çıkarılmayacağını belirtir. Varsayılan:YANLIŞ .
ExportRoundtripInformation { get; set; }HTML, MHTML veya EPUB’a kaydederken gidiş-dönüş bilgilerinin yazıp yazmayacağını belirtir. Varsayılan değer:doğru HTML için veYANLIŞ MHTML ve EPUB. için
ExportShapesAsSvg { get; set; }olup olmadığını kontrol ederShapedüğümler ‘yi HTML, MHTML, EPUB veya AZW3’e kaydederken SVG görüntülerine dönüştürülür. Varsayılan değer:YANLIŞ .
ExportTextInputFormFieldAsText { get; set; }Metin girişi form alanlarının HTML veya MHTML’ye nasıl kaydedileceğini kontrol eder. Varsayılan değer:YANLIŞ .
ExportTocPageNumbers { get; set; }HTML, MHTML ve EPUB’u kaydederken içindekiler tablosuna sayfa numaralarının yazıp yazmayacağını belirtir. Varsayılan değer:YANLIŞ .
ExportXhtmlTransitional { get; set; }HTML’ye veya MHTML’ye kaydederken DOCTYPE bildiriminin yazıp yazmayacağını belirtir. Ne zamandoğru , belgede kök öğeden önce bir DOCTYPE bildirimi yazar. Varsayılan değer:YANLIŞ. EPUB veya HTML5’e kaydederken (Html5 ) DOCTYPE bildirimi her zaman yazılır.
FontResourcesSubsettingSizeThreshold { get; set; }HTML, MHTML veya EPUB’a kaydederken hangi yazı tipi kaynaklarının alt ayarlamaya ihtiyaç duyduğunu kontrol eder. Varsayılan:0 .
FontSavingCallback { get; set; }Bir belge HTML, MHTML veya EPUB’a kaydedildiğinde yazı tiplerinin nasıl kaydedileceğini kontrol etmenizi sağlar.
FontsFolder { get; set; }Bir belgeyi HTML’ye aktarırken yazı tiplerinin kaydedildiği fiziksel klasörü belirtir. Varsayılan, boş bir dizedir.
FontsFolderAlias { get; set; }Bir HTML belgesine yazılan yazı tipi URI’lerini oluşturmak için kullanılan klasörün adını belirtir. Varsayılan, boş bir dizedir.
HtmlVersion { get; set; }Belgeyi HTML veya MHTML’ye kaydederken kullanılması gereken HTML standardı sürümünü belirtir. Varsayılan değer:Xhtml .
ImageResolution { get; set; }HTML, MHTML veya EPUB’a dışa aktarırken görüntülerin çıktı çözünürlüğünü belirtir. Varsayılan:96 dpi .
ImageSavingCallback { get; set; }Bir belge HTML, MHTML veya EPUB’a kaydedildiğinde görüntülerin nasıl kaydedileceğini kontrol etmenizi sağlar.
ImagesFolder { get; set; }Bir belgeyi HTML biçimine dışa aktarırken görüntülerin kaydedildiği fiziksel klasörü belirtir. Varsayılan, boş bir dizedir.
ImagesFolderAlias { get; set; }Bir HTML belgesine yazılan görüntü URI’lerini oluşturmak için kullanılan klasörün adını belirtir. Varsayılan, boş bir dizedir.
ImlRenderingMode { get; set; }Mürekkep (InkML) nesnelerinin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
MemoryOptimization { get; set; }Belgeyi kaydetmeden önce bellek optimizasyonunun gerçekleştirilip gerçekleştirilmeyeceğini belirleyen değeri alır veya ayarlar. Bu özellik için varsayılan değer:YANLIŞ .
MetafileFormat { get; set; }HTML, MHTML veya EPUB’a dışa aktarırken meta dosyalarının hangi formatta kaydedileceğini belirtir. Varsayılan değer:Png , meta dosyalarının PNG görüntülerine raster olarak işlendiği anlamına gelir.
NavigationMapLevel { get; set; }EPUB, MOBI veya AZW3 formatlarına dışa aktarırken gezinme haritasına doldurulan maksimum başlık düzeyini belirtir. Varsayılan değer:3 .
OfficeMathOutputMode { get; set; }OfficeMath nesnelerinin HTML, MHTML veya EPUB’a nasıl aktarıldığını kontrol eder. Varsayılan değer:Image .
PrettyFormat { get; set; }Ne zamandoğru uygulanabilir olduğu yerde güzel formatlarda çıktı. Varsayılan değer:YANLIŞ .
ProgressCallback { get; set; }Bir belge kaydedilirken çağrılır ve kaydetme işlemiyle ilgili verileri kabul eder.
ResolveFontNames { get; set; }Belgede kullanılan yazı tipi ailesi adlarının ‘ye göre çözümlenip değiştirilmeyeceğini belirtirFontSettings HTML tabanlı formatlara yazılırken.
ResourceFolder { get; set; }Bir document HTML’ye aktarıldığında görüntüler, yazı tipleri ve harici CSS gibi tüm kaynakların kaydedildiği fiziksel bir klasörü belirtir. Varsayılan boş bir dizedir.
ResourceFolderAlias { get; set; }Bir HTML belgesine yazılan tüm kaynakların URI’lerini oluşturmak için kullanılan klasörün adını belirtir. Varsayılan, boş bir dizedir.
override SaveFormat { get; set; }Bu kaydetme seçenekleri nesnesi kullanılırsa belgenin kaydedileceği biçimi belirtir. OlabilirHtml ,Mhtml ,Epub , Azw3 veyaMobi .
ScaleImageToShapeSize { get; set; }Görüntülerin HTML, MHTML veya EPUB’a aktarılırken Aspose.Words tarafından sınırlayıcı şekil boyutuna ölçeklenip ölçeklenmeyeceğini belirtir. Varsayılan değer:doğru .
TableWidthOutputMode { get; set; }Tablo, satır ve hücre genişliklerinin HTML, MHTML veya EPUB’a nasıl aktarıldığını kontrol eder. Varsayılan değer:All .
TempFolder { get; set; }Bir DOC veya DOCX dosyasına kaydederken kullanılan geçici dosyalar için klasörü belirtir. Varsayılan olarak bu özellikhükümsüz ve hiçbir geçici dosya kullanılmaz.
UpdateCreatedTimeProperty { get; set; }Bir değer alır veya ayarlar.CreatedTime özellik kaydedilmeden önce güncellenir. Varsayılan değer:YANLIŞ ;
UpdateFields { get; set; }Belgeyi sabit bir sayfa formatında kaydetmeden önce belirli türlerdeki alanların güncellenmesi gerekip gerekmediğini belirleyen bir değer alır veya ayarlar. Bu özellik için varsayılan değer:doğru .
UpdateLastPrintedProperty { get; set; }Bir değer alır veya ayarlar.LastPrinted özellik kaydedilmeden önce güncellenir.
UpdateLastSavedTimeProperty { get; set; }Bir değer alır veya ayarlar.LastSavedTime özellik kaydedilmeden önce güncellenir.
UseAntiAliasing { get; set; }Oluşturma için kenar yumuşatma kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.
UseHighQualityRendering { get; set; }Yüksek kaliteli (yani yavaş) oluşturma algoritmalarının kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.

Örnekler

Bağlantılı görsellerin .html’ye kaydedildikten sonra saklanacağı klasörün nasıl belirleneceğini gösterir.

Document doc = new Document(MyDir + "Rendering.docx");

string imagesDir = Path.Combine(ArtifactsDir, "SaveHtmlWithOptions");

if (Directory.Exists(imagesDir))
    Directory.Delete(imagesDir, true);

Directory.CreateDirectory(imagesDir);

// Form alanlarını HTML giriş öğeleri yerine düz metin olarak dışa aktarmak için bir seçenek belirleyin.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Html)
{
    ExportTextInputFormFieldAsText = true, 
    ImagesFolder = imagesDir
};

doc.Save(ArtifactsDir + "HtmlSaveOptions.SaveHtmlWithOptions.html", options);

Bir belgeyi .epub’a kaydederken belirli bir kodlamanın nasıl kullanılacağını gösterir.

Document doc = new Document(MyDir + "Rendering.docx");

// Kaydedeceğimiz belgenin kodlamasını belirtmek için SaveOptions nesnesini kullanın.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.SaveFormat = SaveFormat.Epub;
saveOptions.Encoding = Encoding.UTF8;

// Varsayılan olarak, bir çıktı .epub belgesinin tüm içeriği tek bir HTML bölümünde bulunur.
// Bölme kriteri, belgeyi birkaç HTML parçasına ayırmamıza olanak tanır.
// Belgeyi başlık paragraflarına bölmek için kriterleri belirleyeceğiz.
// Bu, belirli bir boyuttan daha büyük HTML dosyalarını okuyamayan okuyucular için kullanışlıdır.
saveOptions.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;

// Belge özelliklerini dışa aktarmak istediğimizi belirtin.
saveOptions.ExportDocumentProperties = true;

doc.Save(ArtifactsDir + "HtmlSaveOptions.Doc2EpubSaveOptions.epub", saveOptions);

Bir belgenin nasıl parçalara ayrılacağını ve kaydedileceğini gösterir.

public void DocumentPartsFileNames()
{
    Document doc = new Document(MyDir + "Rendering.docx");
    string outFileName = "SavingCallback.DocumentPartsFileNames.html";

    // Belgenin "Save" yöntemine aktarabileceğimiz bir "HtmlFixedSaveOptions" nesnesi oluşturun
    // belgeyi HTML'ye nasıl dönüştüreceğimizi değiştirmek için.
    HtmlSaveOptions options = new HtmlSaveOptions();

    // Belgeyi normal şekilde kaydedersek tek bir çıktı HTML'si olacaktır
    // kaynak belgenin tüm içeriğini içeren belge.
    // "DocumentSplitCriteria" özelliğini "DocumentSplitCriteria.SectionBreak" olarak ayarlayın
    // belgemizi birden fazla HTML dosyasına kaydedin: her bölüm için bir tane.
    options.DocumentSplitCriteria = DocumentSplitCriteria.SectionBreak;

    // Belge bölümü kaydetme mantığını değiştirmek için "DocumentPartSavingCallback" özelliğine özel bir geri çağırma atayın.
    options.DocumentPartSavingCallback = new SavedDocumentPartRename(outFileName, options.DocumentSplitCriteria);

    // Eğer görseller içeren bir belgeyi html'ye dönüştürürsek, birden fazla görsele bağlantı veren bir html dosyası elde ederiz.
    // Her görüntü yerel dosya sisteminde bir dosya biçiminde olacaktır.
    // Her görüntünün adını ve dosya sistemi konumunu özelleştirebilen bir geri çağırma da vardır.
    options.ImageSavingCallback = new SavedImageRename(outFileName);

    doc.Save(ArtifactsDir + outFileName, options);
}

/// <summary>
/// Kaydetme işleminin bir belgeyi böldüğü çıktı belgeleri için özel dosya adlarını ayarlar.
/// </summary>
private class SavedDocumentPartRename : IDocumentPartSavingCallback
{
    public SavedDocumentPartRename(string outFileName, DocumentSplitCriteria documentSplitCriteria)
    {
        mOutFileName = outFileName;
        mDocumentSplitCriteria = documentSplitCriteria;
    }

    void IDocumentPartSavingCallback.DocumentPartSaving(DocumentPartSavingArgs args)
    {
        // Kaynak belgenin tamamına "Belge" özelliği aracılığıyla erişebiliriz.
        Assert.True(args.Document.OriginalFileName.EndsWith("Rendering.docx"));

        string partType = string.Empty;

        switch (mDocumentSplitCriteria)
        {
            case DocumentSplitCriteria.PageBreak:
                partType = "Page";
                break;
            case DocumentSplitCriteria.ColumnBreak:
                partType = "Column";
                break;
            case DocumentSplitCriteria.SectionBreak:
                partType = "Section";
                break;
            case DocumentSplitCriteria.HeadingParagraph:
                partType = "Paragraph from heading";
                break;
        }

        string partFileName = $"{mOutFileName} part {++mCount}, of type {partType}{Path.GetExtension(args.DocumentPartFileName)}";

        // Aspose.Words'ün belgenin her bölümünü nereye kaydedeceğini belirlemenin iki yolu aşağıda verilmiştir.
        // 1 - Çıktı parçası dosyası için bir dosya adı belirleyin:
        args.DocumentPartFileName = partFileName;

        // 2 - Çıktı parça dosyası için özel bir akış oluşturun:
        args.DocumentPartStream = new FileStream(ArtifactsDir + partFileName, FileMode.Create);

        Assert.True(args.DocumentPartStream.CanWrite);
        Assert.False(args.KeepDocumentPartStreamOpen);
    }

    private int mCount;
    private readonly string mOutFileName;
    private readonly DocumentSplitCriteria mDocumentSplitCriteria;
}

/// <summary>
/// HTML dönüştürmesinin oluşturduğu görüntü dosyaları için özel dosya adlarını ayarlar.
/// </summary>
public class SavedImageRename : IImageSavingCallback
{
    public SavedImageRename(string outFileName)
    {
        mOutFileName = outFileName;
    }

    void IImageSavingCallback.ImageSaving(ImageSavingArgs args)
    {
        string imageFileName = $"{mOutFileName} shape {++mCount}, of type {args.CurrentShape.ShapeType}{Path.GetExtension(args.ImageFileName)}";

        // Aspose.Words'ün belgenin her bölümünü nereye kaydedeceğini belirlemenin iki yolu aşağıda verilmiştir.
        // 1 - Çıktı görüntü dosyası için bir dosya adı belirleyin:
        args.ImageFileName = imageFileName;

        // 2 - Çıktı görüntü dosyası için özel bir akış oluşturun:
        args.ImageStream = new FileStream(ArtifactsDir + imageFileName, FileMode.Create);

        Assert.True(args.ImageStream.CanWrite);
        Assert.True(args.IsImageAvailable);
        Assert.False(args.KeepImageStreamOpen);
    }

    private int mCount;
    private readonly string mOutFileName;
}

Ayrıca bakınız

HtmlOfficeMathOutputMode Enum HtmlVersion Enum