Dönüştürücü Eklentisi

Belgeleri 45 hedef formata dönüştürün

Dönüştürücü eklentisi, Doconut'u bir belge dönüştürme hizmetine dönüştürür. Genel DocumentConverter arayüzünün arkasındaki motoru sağlar ve — isteğe bağlı olarak — kendi HTTP sözleşmesine sahip bir yerleştirilebilir widget sunar, böylece belgeleri C#'tan, widget'tan veya kendinizin yazdığı bir ön uçtan dönüştürebilirsiniz.

YöntemNe zaman kullanılır
DocumentConverter (C#)Sunucuda, tarayıcı olmadan dönüştürürsünüz
Yerleştirilebilir widget (doconutConverter.js)Sayfanızda hazır bir yükleme, dönüştürme ve indirme ekranı istiyorsunuz
HTTP uç noktaları (?convert=open|run|download)Belgelendirilmiş bir sunucu sözleşmesine karşı kendi dönüştürme UI'nizi oluşturursunuz

Paketi kurun

En son kararlı Dönüştürücü eklentisini kurun:

bash
dotnet add package Doconut.NETStandard.Converter

Bu belgelerin açıkladığı sürüme eklentiyi sabitlemek için, sürümü ayrı olarak geçirin:

bash
dotnet add package Doconut.NETStandard.Converter --version 26.10.0

Dönüştürücü paketini Doconut.NETStandard ile aynı sürümde tutun. Paket kimliği Doconut.NETStandard.Converter; .<version> yalnızca indirilen .nupkg dosya adında görünür.

Eklentinin lisans dosyası, Doconut.Viewer.Converter.lic, Doconut.Viewer.lic ile aynı klasöre konur; görüntüleyici lisansı ile birlikte okunur.

Eklentiyi kaydedin

AddConverter() yöntemi yoktur — Doconut'un eklenti modeli tekdüzeldir. Her eklenti, Dönüştürücü dahil, aynı şekilde kaydedilir: AddDoconut() içinde AddPlugin<TPlugin>() çağırın. ConverterPlugin kendi NuGet paketinde, Doconut.NETStandard.Converter, temel görüntüleyici paketiyle birlikte kurulur.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});

Bu, C# arayüzünün ihtiyaç duyduğu tüm şeydir. Widget ve HTTP uç noktaları ayrı bir isteğe bağlı özelliktir, AddConverterWidget() (bkz. Yerleştirilebilir widget).

Eklenti, Converter yeteneğini veren bir lisansa ihtiyaç duyar. Lisans olmadan, AddDoconut() uygulama başlatıldığında bir InvalidOperationException fırlatır, uygulama bir istek hizmet vermeden önce:

text
The Converter plugin is registered via AddPlugin but no active license grants Converter. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.

Lisans yoksa, eski bir TRIAL dosyası, Converter içermeyen bir lisans ve sürüm penceresi dışındaki bir ücretli lisans için fırlatır. Geçici Demo/NFR lisansları kabul edilir. Sessiz bir ücretsiz katman yoktur. Lisansların nasıl yüklendiği için Lisans Kurulumu bölümüne bakın.

Lisanslama ve filigran

Lisans durumuBaşlangıçDönüştürme çıktısı
Ücretli görüntüleyici lisansı, Converter yetkisi verir, sürüm penceresi içindeBaşlarTemiz — watermarked: false
Etkin Geçici (Demo/NFR) lisansBaşlarDönüştürür, değerlendirme filigranı — watermarked: true
Süresi dolmuş Geçici (Demo/NFR) lisansBaşlarDönüştürür, değerlendirme filigranı — watermarked: true
Lisans yok, eski bir TRIAL dosyası, Converter içermeyen bir lisans veya sürüm penceresi dışındaki bir ücretli lisansAddDoconut() fırlatır—

Her iki çağrı yolu da aynı kuraldan bayrağı hesaplar: DocumentConverter C# arayüzü, lisansın IsViewerLicensed ve IsTemporary durumundan dahili olarak türetir ve widget'ın ?convert=run işleyicisi eşdeğer kontrolü (IsViewerLicensed && !IsTrial && !IsTemporary) yaparak döndürdüğü watermarked alanını doldurur. Bir bütünleşme, satın almadan önce bir değerlendirme lisansı üzerinde uçtan uca oluşturulup test edilebilir — sadece çıktı baytları değişir.

Bir DICOM kaynağı (.dcm, .ima) ayrıca Dicom yeteneğine ihtiyaç duyar. Bunun olmaması durumunda, ConvertAsync bir LicenseException (Converting '.dcm' requires the Dicom capability license.) fırlatır ve widget'ın open yanıtı 403.

C#'dan Kullanım

Her dönüşüm, 0 konumunda konumlandırılmış, hemen okuma veya kopyalama için hazır bir seekable MemoryStream döndürür. DocumentConverter'i ihtiyacınız olduğu yerde DI'dan çözün — tasarım gereği durum bilgisizdir, bu yüzden tek bir örnek istekler arasında güvenle yeniden kullanılabilir.

csharp
// DocumentConverter'ı enjekte edin; yapıcı içsel olduğu için, asla `new` yapmayın.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension baştaki noktayı içerir. password, belge korunmuyorsa null olur.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// html: Word belgesine geri dönüştürülecek HTML'i tutan bir Stream, örneğin WordToHtmlAsync sonucunda elde edilen.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);

Yanlış yapılması kolay iki detay: stream overload'unda sourceExtension, baştaki noktayı (".xlsx", "xlsx" değil) içermelidir — dönüştürücü bunu format kataloğuna karşı eşleştirir ve yalnız bir uzantı çözülemez. Ve adının aksine, WordToHtmlAsync Task<Stream> döndürür, Task<string> değil — HTML belgesini (görseller Base64 olarak gömülü) bir akış olarak alırsınız, diğer tüm dönüşüm sonuçları gibi.

Çağıran, döndürülen akışın sahibidir ve içeriği kopyaladıktan ya da döndürdükten sonra onu dispose etmelidir. DocumentConverter servisi kendisi bağımlılık enjeksiyonundan çözülür; elle oluşturmayın ya da dispose etmeyin.

Hedef formatlar

ConversionTarget (namespace Doconut.Configs.Conversion) 45 üyeye sahiptir:

text
Pdf, Docx, Doc, Html, Xlsx, Pptx, Png, Jpeg, Csv, Tiff, Bmp, Gif, Svg, Xml,
Txt, Xls, Jp2, Rtf, Odt, Ods, Odp, Epub, Xps, Webp, Msg, Eml, Emlx, Mhtml,
Xlsm, Xlsb, Ppt, Docm, Dot, Dotx, Dotm, Vsdx, Vssx, Vstx, Vsdm, Vssm, Vstm,
Vdx, Vsx, Vtx, Ico

Her kaynak her hedefe dönüştürülmez — eklenti, her kaynağın format ailesini (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, web document, DICOM) kendi sabit izin verilen hedef kümesine eşler. Bir DICOM kaynağını (.dcm, .ima) dönüştürmek ayrıca Dicom yeteneğini veren bir lisans gerektirir; hedefleri Pdf, Png, Jpeg, Bmp, Tiff ve Gif'dır. Bu enum'ı UI'nizin hedef listesi olarak sabit kodlamayın: ?convert=open, yeni yüklenen dosya için gerçek allowedTargets'ı döndürür ve bu, bir seçim kutusunu yönlendirmelidir.

Yerleştirilebilir widget

Uç noktaları etkinleştir

Widget'ın ?convert=open|run|download uç noktaları isteğe bağlıdır ve kutudan çıktığında devre dışıdır — varsayılan olarak güvenlidir. Sunucu tarafında, eklenti kaydıyla birlikte etkinleştirin:

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
    options.AddConverterWidget(widget =>
    {
        widget.MaxUploadMb = 25;
    });
});

AddConverterWidget() argümansız olarak widget'ı varsayılanlarla etkinleştirir (MaxUploadMb = 25). Tek başına dönüşüm hakları sağlamaz: AddPlugin<ConverterPlugin>() gerekir, aksi takdirde AddDoconut() bir istisna fırlatır:

text
AddConverterWidget() was called but the Converter plugin is not registered. Add options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() (the widget needs it), or remove the AddConverterWidget() call.

AddConverterWidget() olmadan, üç ?convert= uç nokta 404 yanıt verir — ancak JS dosyası yine de sunulur (bu, düz gömülü bir statik kaynak; yalnızca iletişim kurduğu uç noktalar kısıtlanmıştır).

Göm

html
<div id="doconut-convert"></div>
<script src="/doconut-res/js/doconutConverter.js"></script>
<script>
  Doconut.convert('#doconut-convert', { basePath: '/doconut', resPath: '/doconut-res', maxUploadMb: 25 });
</script>

Doconut.convert(selectorOrElement, options) bir CSS seçicisi veya bir öğe alır, bağlama bulunamazsa hata fırlatır ve bir tutamaç döndürür. Widget bir dosya yükler, sayfa 1'in önizlemesini gösterir, kullanıcının allowedTargets arasından birini seçmesine izin verir, dönüştürür, mümkün olduğunda sonucu önizler ve indirme seçeneği sunar.

Seçenekler

SeçenekTürVarsayılanNotlar
basePathstring/doconut?convert= uç noktaları için temel yol; UseDoconut() gerçekte bağlandığı ASP.NET dalıyla eşleşmelidir (genellikle MiddlewarePath aracılığıyla koordine edilir)
resPathstring/doconut-resDiğer Doconut widget'larıyla yapılandırma tutarlılığı için kabul edilir; dönüştürücü widget şu anda bundan herhangi bir URL oluşturmaz
maxUploadMbnumber25Yalnızca istemci tarafı ön kontrol — yüklemeden önce çok büyük bir dosyayı reddeder. Sunucu bağımsız olarak kendi sınırını uygular ve aşılırsa 413 yanıtını verir
licenseUrlstring | nullnullAyarlandığında, sonuç ekranındaki filigran bildirimini bu URL'ye bir bağlantıya dönüştürür
labelsobject{}Widget'ın İngilizce varsayılan metinlerinin (bırakma metni, düğmeler, aria-live duyuruları, hata mesajları) herhangi bir alt kümesini geçersiz kılar

Geri Çağrılar

Geri ÇağrıNe zaman tetiklenirYük
onReady()Widget boş/bırakma ekranını render ettiğinde—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open başarılı olduğundakaynak oturum belirteci, sayfa sayısı, kaynak uzantısı (başında nokta yok), izin verilen hedef listesi
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run başarılı olduğundaçalıştırma yanıtı ile aynı alanlar, ayrıca istenen target
onDownload({ downloadName, downloadToken })Kullanıcı İndir bağlantısına tıkladığındatarayıcının yerel indirmesiyle birlikte tetiklenir — engellemez veya değiştirmez
onError({ phase, message })Bir açma veya çalıştırma isteği başarısız olduğundaphase, 'open' veya 'run'; message, temizlenmiş sunucu hatasıdır (veya yük‑boyutu ön‑kontrolü için istemci tarafı mesajı)

Bir geri çağrı hata fırlattığında yakalanır ve kaydedilir; widget akışını asla bozmaz.

İmperatif tutamaç

Doconut.convert() widget örneğini kendisini döndürür — programlı olarak widget'ı kontrol etmek için tutun:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // kendi <input type="file" id="picker"> öğenizden bir File
conv.reset();         // idle/drop ekranına geri dön; onReady tekrar tetiklenmez
conv.loadFile(file);  // akışı bir File nesnesiyle başlatır; şu anda boşta değilse hiçbir işlem yapmaz
conv.destroy();       // dinleyicileri kaldırır, mount'ı boşaltır; bu işlemden sonra örnek kullanılamaz

Etiketler

Her dize bir İngilizce varsayılan değere sahiptir; labels herhangi bir alt kümeyi geçersiz kılar ve geri kalanlar İngilizce kalır. Çalışma zamanında değişen parçalar {placeholders} kullanır, örneğin uploading: 'Uploading {name}…' ve pages: '{n} pages'.

Anahtarİngilizce varsayılan
dropPromptDrag & drop a document here
dropHintPDF, Word, Excel, PowerPoint, images and more
chooseFileChoose file
uploadingUploading {name}…
page / pages1 page / {n} pages
noTargetsNo conversion targets are available for this file.
convertTo / convertConvert to / Convert
convertingConverting to {target}…
readyToDownloadReady to download
download / convertAnotherDownload / Convert another
watermarkNoticeOutput is watermarked — get a license to remove it.
retryRetry
genericErrorSomething went wrong. Please try again.
sizeLimitThat file is larger than the {mb} MB upload limit. Please choose a smaller file.
serverErrorThe server could not process this request. Please try again.
networkErrorCould not reach the server. Please check your connection and try again.

Diğer anahtarlar, bırakma bölgesinin aria-label (dropAriaLabel), ön izleme alt metinlerini (previewAlt, resultAlt), licenseUrl ile kullanılan filigran bildiriminin bağlanmış biçimini (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), okunamayan bir yanıtı (badResponse) ve aria-live duyurularını (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError) kapsar.

Sunucudan gelen bir JSON hatası, sunucunun yazdığı şekilde gösterilir; serverError yalnızca başarısız bir yanıt JSON hatası içermediğinde, örneğin devre dışı bırakılmış bir widget'ın 404 gibi durumlarda kullanılır.

Temalandırma

Widget, dcw sınıfını monte elemanına ekler ve renklerini, yarıçapını ve yazı tipini CSS özel özelliklerinden okur, böylece iç yapısına dokunmadan temalandırabilirsiniz:

css
#doconut-convert.dcw {
  --dcw-accent: #6b46c1;
  --dcw-radius: 12px;
  --dcw-font: "Inter", system-ui, sans-serif;
}

Varsayılanlar: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px ve --dcw-font için bir sistem UI yazı tipi.

Kendi ön ucunuzu oluşturun

Widget, bu HTTP sözleşmesi için yalnızca bir istemcidir — farklı bir kullanıcı deneyimi için ona doğrudan kendi ön ucunuzu oluşturun. Üç rotanın tamamı, UseDoconut()'ın (normalde /doconut) monte edildiği ASP.NET dalı altında bulunur ve AddConverterWidget() çağrılana kadar 404 yanıt verir. Hatalar bir JSON gövdesi, { "error": "..." } taşır, tablo "yalnızca durum" dediği yerler hariç. Bilinmeyen bir ?convert= değeri 400 yanıt verir.

RotaAmaçBaşarılı yanıt
POST ?convert=open (multipart, one file)Kaynak belgeyi yükleyin ve ön izleme için açın200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Saklanan kaynağı target'a dönüştür200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Dönüştürülmüş dosyayı akış olarak gönder200 — dosya baytları, Content-Disposition: attachment, Cache-Control: no-store

sourceExt, open yanıtında başta nokta yoktur (ör. "docx") — DocumentConverter.ConvertAsync üzerindeki sourceExtension parametresinin ters konvansiyonu, bu parametre bir nokta gerektirir. allowedTargets, küçük harf hedef adlarını listeler ("pdf", "html", …); bunlardan birini target olarak geçirin, eşleşme büyük/küçük harfe duyarsızdır. open, çok parçalı gövde içindeki ilk dosyayı kullanır.

resultToken, null'dır ve sonuç ön izlenemediğinde resultPages, 0'dır. downloadName, hedefin uzantısıyla kaynak dosya adıdır.

Ön izleme görüntüleri, standart görüntüleyici resim rotasını, {basePath}?token={token}&page=1&thumb=1&width={px}, kullanır; open'dan gelen token veya run'dan gelen resultToken ile. Widget, width=240 ister.

Yüklenen kaynak baytları sunucu tarafında saklanır ve son okunduktan 30 dakika tutulur; bu süre dolduğunda, run 404 yanıt verir ve dosya yeniden açılmalıdır. Dönüştürülmüş sonuç aynı saklamada bulunur — dönüşüm tamamlandığında downloadToken kendi yeni 30 dakikalık süresini alır — resultToken ise sonucu ön izlemek için sıradan bir görüntüleyici oturum tokenıdır. Sonuç ön izlenebildiğinde, downloadToken ve resultToken aynı değerdir. Bir görüntüleyici sonucunu kapatmak hâlâ geçerli bir indirme saklamasını silmez ve tarayıcı widget'ını sıfırlamak da hiçbir pencereyi uzatmaz.

Başarısızlık modları, rotaya göre gruplanmıştır:

RotaDurumNe zamanGövde
herhangi404Widget etkinleştirilmemiş (AddConverterWidget() hiç çağrılmadı) — üç rotadan herhangi biri yönlendirilmeden önce kontrol ediliryalnızca durum
herhangi405Yanlış HTTP fiili (open/run POST gerektirir; download GET gerektirir)yalnızca durum
open400Çok parçalı bir yükleme değilExpected a multipart file upload.
open400Dosya yok ya da boşNo file uploaded.
open400Dönüştürülemeyen bir kaynak uzantısıThis file type cannot be converted.
open403Dosya türü, lisansın sağlamadığı bir yeteneğe ihtiyaç duyar (Dicom olmayan bir DICOM dosyası)Converting this file type requires the Dicom capability license.
open413Yüklenen dosya MaxUploadMb'ı aşıyor, Content-Length'a karşı kontrol edilir ve yükleme okunurkenFile is too large.
run400Bozuk token (GUID değil)Invalid token.
run400Bir target, bir ConversionTarget'a ayrıştırılamıyorUnknown target format.
run400target kaynağın allowedTargets içinde değilThat target format is not available for this file.
run404Saklanan yükleme süresi dolmuş veya token hiç açılmamışUpload expired — please re-open the file.
open, run500İşleme dahili olarak başarısız olduTemizlenmiş bir mesaj — diğer tüm Doconut hata yolları gibi temizlenir; iç detayları asla ortaya çıkarmaz
download400Bozuk token (GUID değil)yalnızca durum
download404Bilinmeyen veya süresi dolmuş indirme tokenıyalnızca durum

fetch ile tam bir tur:

javascript
// file: dönüştürülecek File, örneğin <input type="file">.
async function convertFile(file) {
  const base = '/doconut';

  // 1. open: dosyayı yükle
  const form = new FormData();
  form.append('file', file, file.name);
  const openResp = await fetch(base + '?convert=open', { method: 'POST', body: form });
  if (!openResp.ok) throw new Error((await openResp.json()).error);
  const opened = await openResp.json();

  // 2. run: izin verildiğinde PDF'ye dönüştür, aksi takdirde ilk izin verilen hedefe
  const target = opened.allowedTargets.includes('pdf') ? 'pdf' : opened.allowedTargets[0];
  const runResp = await fetch(base + '?token=' + encodeURIComponent(opened.token) +
    '&convert=run&target=' + target, { method: 'POST' });
  if (!runResp.ok) throw new Error((await runResp.json()).error);
  const converted = await runResp.json();

  // 3. download: tarayıcının takip edebileceği basit bir GET
  window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}

Uç noktalar aynı kaynaklıdır: bu sürüm CORS desteği içermez. UI'nizi ve widget betiğini Doconut ile aynı kaynaktan sunun, ya da her iki /doconut yolunu (middleware yolu ve kaynak yolu) UI'nizin kaynağı altında ters proxy yapın.

Üretimde

  1. Eklentiyi kurun çekirdek paketin yanına, aynı sürümde: dotnet add package Doconut.NETStandard.Converter.
  2. Lisans dosyasını ekleyin. Doconut.Viewer.Converter.lic'yi Doconut.Viewer.lic ile aynı klasöre koyun.
  3. Sunucu sınırını ayarlayın. MaxUploadMb, AddConverterWidget içinde, sunucunun uyguladığı sınırdır; widget'in maxUploadMb sadece istemci tarafı bir kontroldür. İkisini eşit tutun.
  4. UI'yi aynı origin'den sunun Doconut uç noktalarıyla aynı origin'den, ya da ters proxy yapın (bkz. Kendi ön ucunuzu oluşturun).
  5. Dönüştürme sonuçlarını serbest bırakın. ConvertAsync akışı havuzlanmıştır; onu serbest bırakmak, tamponlarını havuza geri verir.

Web çiftlikleri

Widget, her yüklemeyi ve sonucunu, open hizmet veren düğümde bellekte tutar. Yapışkan oturumlar olmadan bir yük dengeleyicinin arkasında, daha sonraki bir run, download veya ön izleme isteği başka bir düğüme ulaşabilir ve yüklemeyi bulamaz. Paylaşılan, şifreli widget deposunu bir kez, AddDoconut() sonrası kaydedin:

csharp
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // her düğümün okuyup yazabileceği bir klasör
    store.FarmKey = farmKey;                   // en az 32 bayt, her düğümde aynı
    // store.Ttl = TimeSpan.FromMinutes(30);   // bir yüklemenin ne kadar süre saklandığı (varsayılan)
});
  • Tek bir sunucu hiçbir şeye ihtiyaç duymaz: bu çağrı olmadan bellek içi mağaza kullanılır.
  • Yüklemeler ve sonuçlar paylaşılda dinlenirken şifrelenir (AES-256, encrypt-then-MAC) ve her dosya token'ına bağlanır, böylece bir token başka birinin dosyasını asla okuyamaz.
  • Paylaşılda, bir yükleme veya sonuç, yazıldıktan sonra Ttl süreyle tutulur; okuma bu süreyi uzatmaz.
  • FarmKey en az 32 bayt olmalı ve her düğümde aynı olmalıdır. Gizli bir depodan yükleyin; asla sabit kodlamayın. Kayıt, RootPath eksik olduğunda veya FarmKey 32 bayttan kısa olduğunda bir ArgumentException fırlatır.
  • RootPath'i dağıtılmış görüntüleyicinin kullandığı aynı paylaşılan konuma yönlendirin.

API referansı

Facade ve widget seçenekleri Doconut ad alanında bulunur; ConversionTarget Doconut.Configs.Conversion içinde. ConverterPlugin Doconut.Plugins.Converter içinde.

DocumentConverter

csharp
public sealed class DocumentConverter
{
    public Task<Stream> ConvertAsync(
        string filePath, ConversionTarget target,
        string? password = null, CancellationToken ct = default);

    public Task<Stream> ConvertAsync(
        Stream source, string sourceExtension, ConversionTarget target,
        string? password = null, CancellationToken ct = default);

    public Task<Stream> WordToHtmlAsync(string filePath, CancellationToken ct = default);

    public Task<Stream> HtmlToWordAsync(
        Stream htmlSource, ConversionTarget outputFormat = ConversionTarget.Docx,
        CancellationToken ct = default);
}

Bağımlılık enjeksiyonundan çözülür; yapıcı içtedir. sourceExtension önde nokta içerir. HtmlToWordAsync, outputFormat ConversionTarget.Doc olduğunda bir .doc dosyası yazar ve diğer tüm değerler için bir .docx dosyası yazar.

ConversionTarget

45 çıktı formatı Hedef formatlar içinde listelenmiştir.

ConverterWidgetOptions

csharp
public sealed class ConverterWidgetOptions
{
    public int MaxUploadMb { get; set; } = 25;
}

DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null) aracılığıyla ayarlanır, bu da DoconutOptions döndürür, böylece çağrılar zincirlenebilir.

Sorun Giderme

SymptomCauseFix
AddDoconut() throws The Converter plugin is registered via AddPlugin but no active license grants Converter.Lisans yok, bir TRIAL dosyası, Converter içermeyen bir lisans veya sürüm penceresinin dışında bir ücretli lisansConverter sağlayan bir lisans kurun veya AddPlugin<ConverterPlugin>() kaldırın
AddDoconut() throws AddConverterWidget() was called but the Converter plugin is not registered.Widget, eklentisi olmadan etkinleştirildioptions.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() ekleyin
Resolving DocumentConverter throws No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin kayıtlı değilAddDoconut() içinde AddPlugin<ConverterPlugin>() ekleyin
Stream conversion says the format is unsupportedsourceExtension başında nokta yok".xlsx" geçirin, "xlsx" değil
ConvertAsync throws Converting '.dcm' requires the Dicom capability license.Bir DICOM kaynağı ve lisans Dicom sağlamıyorDicom sağlayan bir lisans kullanın
The output is watermarkedLisans geçicidir (Demo/NFR)Converter sağlayan bir ücretli lisans kullanın
The widget loads but its requests answer 404AddConverterWidget() çağrılmadı veya basePath, UseDoconut()'nin monte edildiği dal ile eşleşmiyorAddConverterWidget() çağırın; basePath düzeltin
open answers 403 Converting this file type requires the Dicom capability license.Bir DICOM yüklemesi ve lisans Dicom sağlamıyorDicom sağlayan bir lisans kullanın
open answers 413 File is too large.Yükleme MaxUploadMb'ı aşıyorAddConverterWidget içinde MaxUploadMb yükseltin; widget'in maxUploadMb sadece istemci tarafı bir kontroldür
run answers 400 That target format is not available for this file.Hedef, kaynağın allowedTargets'larından biri değilopen'den sadece allowedTargets sunun
run or download answers 404 (Upload expired — please re-open the file. from run)30 dakikalık pencere geçti veya bir web-farm düğümü yüklemeyi içermiyorDosyayı tekrar açın; bir çiftlikte, AddDoconutDistributedWidgets kaydedin
The widget fails when the UI is on another originUç noktalar CORS desteği yokUI'yi aynı origin'den sunun veya Doconut yollarını ters proxy yapın
The theme does not applyDeğişkenler bir üst öğede veya monte içinde bir öğede ayarlanmış; widget'in kendi .dcw kuralı onları monte üzerine ayarlarMontayı kendisini hedefleyin: #doconut-convert.dcw veya #doconut-convert

Çerçeve notları

  • viewer.Converter.GetConverter() burada mevcut değil. Dönüştürme artık görüntüleyici örneği üzerinden erişilmiyor: bunun yerine Doconut.DocumentConverter enjekte edin.
  • Bu ConversionTarget enum tüm kaynak ailelerini kapsar. Önceki kütüphane, aile başına bir *ConfigConverter türüne sahipti — WordConfigConverter, ExcelConfigConverter vb. — her biri kendi iç içe EnTargetFormat enum'ına sahipti, ayrıca giriş için bir SourceFormatConverter enum vardı. Hepsi kaldırıldı; bkz. göç rehberi.
  • Yalnızca Windows, .NET Standard paketinin geri kalanı gibi.

Bu sayfa yardımcı oldu mu?