Många utvecklare börjar med att leta efter UI‑komponentbibliotek när de behöver visa dokument i en webbapplikation. Doconut Visare är ett .NET‑SDK för att lägga till plugin‑fri webbläsarvisning i ASP.NET Core, MVC eller klassiska WebForms‑projekt. Säkerheten beror fortfarande på hela applikationsarkitekturen: autentisering, auktorisation, transport, lagring, validering, rensning, patchning och övervakning.

1. Installera Doconut App SDK och förbered ditt .NET‑projekt för flera filformat
1.1 Lägg till det stödjade paketet
Använd det aktuella paketet och installationsinstruktionerna från den officiella Doconut‑nedladdningssidan. Notera den valda versionen och verifiera att den stöder den avsedda .NET‑runtime‑miljön.
1.2 Verifiera paketreferensen
Efter installationen, bekräfta paketreferensen och den lösta versionen i projektfilen. Att hålla versioner explicita hjälper till att göra byggen och distributioner reproducerbara.
1.3 Aktivera HTTPS
Doconut App kräver SSL för alla filuppladdningar. Se till att din applikation lyssnar på HTTPS. För en Kestrel‑hostad app, lägg till en endpoint‑konfiguration i appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Om du hostar på IIS, bind ett HTTPS‑certifikat till webbplatsen. Med HTTPS aktiverat färdas varje fil över en säker kanal innan den når Doconut Apps renderingsmotor.
Varför Doconut App?
Doconut App är den enda .NET‑inbyggda visaren som kombinerar noll‑plugin‑rendering med end‑to‑end AES‑256‑kryptering, så att du kan uppfylla efterlevnadskrav utan att lägga till extra infrastruktur.
2. Konfigurera säkra filuppladdningar och lagring för dokumenthantering
Doconut Apps säkerhetsmodell bygger på tre pelare: SSL‑transport, AES‑256‑kryptering i vila och automatisk radering efter visning. SDK‑et tillhandahåller en färdig tjänst som du kan registrera i din applikation.
2.1 Registrera uppladdningstjänsten
I Startup.cs (eller Program.cs för .NET 6+) lägger du till Doconut‑tjänsterna i beroende‑injektionsbehållaren. Konfigurera en temporär lagringsmapp, aktivera AES‑256‑kryptering och ange intervallet för automatisk radering (t.ex. 10 minuter efter att dokumentet har visats).
2.2 Skapa uppladdnings‑endpointen
Implementera en controller‑action som tar emot en uppladdad fil, vidarebefordrar den till Doconut‑tjänsten för säker lagring och returnerar en kort engångstoken. Token är vad klient‑sidans visare använder för att hämta och rendera dokumentet.
2.3 Skydda endpointen
Eftersom uppladdnings‑endpointen hanterar känslig data, skydda den med autentisering och roll‑baserad auktorisation (t.ex. endast användare i rollen DocumentViewer får ladda upp). Detta säkerställer att endast behörig personal kan lagra och visa konfidentiella dokument.
Doconut App‑fördel: SDK‑et hanterar kryptering och rensning åt dig, så du aldrig behöver skriva egen kryptografikod eller oroa dig för övergivna filer.
3. Bädda in visarkomponenten i ASP.NET Core, MVC eller WebForms
När backend är klar, initiera visaren med hjälp av resurserna och API‑et som dokumenteras för den installerade Doconut‑versionen.
3.1 Lägg till JavaScript‑paketet
I din delade layout, inkludera endast de visarresurser som beskrivs i dokumentationen som matchar den installerade SDK:n. Anta inte fasta paketnamn eller platser mellan versioner.
3.2 Skapa en Razor‑vy för Core/MVC
Lägg till en vy (t.ex. Views/Document/View.cshtml) som innehåller ett fil‑input‑fält, ett container‑element för visaren och ett litet skript som laddar upp den valda filen, tar emot den säkra token och initierar Doconut Viewer‑widgeten.
Skriptet ska:
- Fånga den valda filen från
<input type="file">‑elementet. - Skicka filen till uppladdnings‑endpointen med
fetchellerXMLHttpRequest. - När det auktoriserade svaret kommer, initiera visaren med det stödjade API‑et för den installerade versionen.
3.3 WebForms‑motsvarighet
I en WebForms‑sida (t.ex. DocumentViewer.aspx) placerar du en asp:FileUpload‑kontroll, en knapp för att trigga uppladdningen och ett <div> som kommer att hysa visaren. I kod‑bakom, anropa Doconut‑tjänsten för att lagra den uppladdade filen, hämta token och registrera ett start‑skript som anropar en JavaScript‑funktion (initViewer(token)) för att skapa visar‑instansen.
Fördel med Doconut App: En JavaScript‑widget, tre .NET‑UI‑modeller, noll extra bibliotek. Enkelhet i bästa form.
4. Anpassa visaren för dokumenthantering
Direkt ur lådan erbjuder Doconut Viewer en ren verktygsrad, zoom‑kontroller och en växling mellan ljus/dark‑tema. Du kan anpassa UI‑t för att matcha ditt varumärke och passa specifika dokumenttyper.
4.1 Konfiguration av verktygsrad
När du initierar visaren kan du ange vilka verktygsradsobjekt som ska vara synliga (t.ex. download, print, zoomIn, zoomOut, fullScreen). Att ta bort download‑knappen förhindrar exempelvis att användare sparar originalfilen.
4.2 Tema och färger
Ställ in theme‑alternativet till 'dark' eller 'light' och ange eventuellt en primaryColor som matchar ditt företags färgpalett. Visaren respekterar CSS‑variabler, vilket möjliggör djupare styling via ett anpassat stylesheet.
4.3 CAD‑specifika verktyg
Om du visar DWG-, DXF- eller DGN‑filer, aktivera CAD‑alternativen enableMeasurement och enableLayerToggle. Detta lägger till verktyg för avstånds-, vinkel- och area‑mätning samt en lager‑synlighetspanel direkt i verktygsraden.
4.4 Lokalisering
Skicka en locale‑kod (t.ex. 'fr' för franska) under initieringen. Alla UI‑strängar, verktygstips och felmeddelanden visas på det valda språket.
Varför anpassa? Doconut App låter dig behålla visaren som en naturlig förlängning av din webbplats samtidigt som du levererar samma säkra, plugin‑fria upplevelse.
5. Testa integrationen för alla stödjade format
Innan du går live, kör en snabb kontroll för varje filtyp du förväntar dig att användarna ska kunna visa. Med Doconut Apps visare, öppna en exempelfil för varje format och verifiera att rendering, navigation och eventuella specialverktyg fungerar som beskrivet.
| Format | Testscenario | Förväntat resultat |
|---|---|---|
| Stort, flersidigt rapport med inbäddade bilder | Mjuk rullning, zoom och exakt färgrendering | |
| DOCX | Word‑dokument med tabeller och fotnoter | All text, tabeller och fotnoter synliga; ingen layoutförskjutning |
| XLSX | Kalkylblad med diagram | Diagram renderas som vektorgrafik; zoom behåller klarhet |
| PPTX | Bildspel med statisk förhandsgranskning | Första bilden visas korrekt; inga trasiga resurser |
| DWG | Teknisk ritning med flera lager | Lager kan växlas, mätningar fungerar, linjer förblir skarpa |
| PSD | Photoshop‑fil med lager | Lager synliga, färger exakta, zoom förblir skarp |
| SVG | Vektorgrafik med gradienter | Gradienter renderas mjukt; zoom förblir skarp |
| TIFF | Högupplöst skanning | Bild laddas snabbt; zoom avslöjar detaljer |
Att köra igenom denna checklista med Doconut App säkerställer att varje stödjat format beter sig pålitligt för dina användare.
Slutsats
Att bädda in en säker, plugin‑fri dokumentvisare är nu enkelt med Doconut App. Genom att följa stegen ovan — installera SDK:n, konfigurera krypterade uppladdningar, bädda in den lätta JavaScript‑widgeten och anpassa UI‑t — kan du leverera snabb, högkvalitativ dokumentrendering i ASP.NET Core, MVC och WebForms‑applikationer.
Redo att utvärdera den? Börja med den officiella Doconut‑nedladdnings‑ och dokumentationssidan (https://doconut.com/en/download), och testa sedan SDK:n inom samma säkerhetsgranskning som tillämpas på resten av din Windows‑baserade ASP.NET‑applikation.