html xps-ზე

როგორ გადავიტანოთ HTML XPS-ში C# .NET-ში

HTML ფაილი ფართოდ გამოიყენება ინტერნეტში ინფორმაციის გაზიარებისთვის. ვინაიდან მას მხარს უჭერს პლატფორმების უმრავლესობა და თითქმის ყველა ვებ ბრაუზერს შეუძლია ამ ფორმატის ჩატვირთვა, ამიტომ ის მას ერთ-ერთ მისაღებ ფორმატად აქცევს. თუმცა, მისი ფართო აღიარების გამო, ბევრი ჰაკერი ცდილობს მავნე სკრიპტების ჩასმას HTML ფაილებში. მავნე HTML და JavaScript კოდის მაღალი დონის შეტევებმა დრამატულად გაიზარდა როგორც ინფორმირებულობა, ასევე ექსპლუატაცია ბოლო წლებში. მეორე მხარეს, XPS ფაილი წარმოადგენს გვერდის განლაგების ფაილებს, რომლებიც დაფუძნებულია XML ქაღალდის სპეციფიკაციებზე.

  • XPS მსგავსია PDF ფაილის ფორმატის, მაგრამ იყენებს XML-ს დოკუმენტის განლაგების, გარეგნობისა და ინფორმაციის ბეჭდვისას.

HTML კონვერტაციის API

Aspose.HTML Cloud სპეციალურად შექმნილია HTML ფაილების დამუშავების შესაძლებლობების უზრუნველსაყოფად. HTML-ის შეყვანის გარდა, ჩვენ ასევე შეგვიძლია ჩატვირთოთ XHTML, MHTML, EPUB, Markdown ან ვებ გვერდი მისი URL-ით. შედეგი შეიძლება იყოს PDF, XPS, DOCX ან რასტრული გამოსახულების ფორმატები: JPEG, PNG, TIFF, BMP, GIF. ვინაიდან API შემუშავებულია REST არქიტექტურის მიხედვით, ამიტომ მისი გამოყენება შესაძლებელია დესკტოპში, მობილურში, ვებსა და ჰიბრიდულ აპლიკაციებში, ასევე დესკტოპ ან მობილურ პლატფორმებში.

ჩვენი მომხმარებლების შემდგომი ხელშეწყობის მიზნით, ჩვენ შევქმენით პროგრამირების ენის სპეციფიკური SDK-ები. Cloud SDK-ები არის REST API-ების გარსები სხვადასხვა პროგრამირების ენაზე, რაც საშუალებას გაძლევთ დაამუშავოთ დოკუმენტები თქვენს მიერ არჩეულ ენაზე. ამ გზით, თქვენ შეგიძლიათ სწრაფად და მარტივად მიიღოთ ძლიერი ტიპებისა და IDE მაჩვენებლების ყველა უპირატესობა. გთხოვთ, შეამოწმოთ Aspose.HTML GitHub საცავი SDK-ებისთვის სამუშაო მაგალითებთან ერთად, რათა დროულად დაიწყოთ. ამ სტატიაში ჩვენ განვიხილავთ Aspose.HTML Cloud SDK .NET-ის დოკუმენტის კონვერტაციის ფუნქციებს.

ინსტალაცია

Cloud SDK-ის გამოყენების დასაწყებად, პირველი ნაბიჯი არის მისი სისტემაზე ინსტალაცია. SDK ხელმისაწვდომია NuGet და GitHub-ზე. გთხოვთ, შეასრულოთ შემდეგი ბრძანება ტერმინალის ფანჯარაში NuGet-ის ინსტალაციის შესასრულებლად

nuget install Aspose.HTML-Cloud

კიდევ ერთი ვარიანტია SDK-ის დაყენება Visual Studio-ში Package Manager Console-ის მეშვეობით. გთხოვთ შეასრულოთ შემდეგი ბრძანება:

 PM> Install-Package Aspose.HTML-Cloud
პაკეტის მენეჯერის კონსოლი

სურათი 1: - Aspose.HTML NuGet პაკეტი დაინსტალირებულია.

NuGet პაკეტის მენეჯერი

კიდევ ერთი უმარტივესი მიდგომაა SDK-ის დაყენება NuGet Package Manager-ის მეშვეობით Visual Studio IDE-ში.

  1. გახსენით Solution Explorer.
  2. გააფართოვეთ პროექტი და დააწკაპუნეთ მარჯვენა ღილაკით Packages საქაღალდეში თქვენს გადაწყვეტაში.
  3. აირჩიეთ Manage NuGet Packages… ოფცია.
  4. დააწკაპუნეთ ჩანართზე „Browse“ და მოძებნეთ „Aspose.HTML-Cloud“.
  5. დააწკაპუნეთ Aspose.HTML-Cloud პაკეტზე, აირჩიეთ შესაბამისი ვერსია მარჯვენა ჩანართში და დააჭირეთ ღილაკს Add Package.
წარწერა

Image 2:- Aspose.HTML Package in NuGet Package Manager.

უფასო Cloud გამოწერა

შემდეგი მნიშვნელოვანი ნაბიჯი არის უფასო ანგარიშის გამოწერა Aspose.Cloud dashboard-ზე. არ არის საჭირო საკრედიტო ბარათი ან სხვა გადახდის დეტალები. თუ გაქვთ GitHub ან Google ანგარიში, უბრალოდ დარეგისტრირდით ან დააწკაპუნეთ ღილაკზე ახალი ანგარიშის შექმნა და მიაწოდეთ საჭირო ინფორმაცია. ახლა შედით საინფორმაციო დაფაზე რწმუნებათა სიგელების გამოყენებით და გააფართოვეთ აპლიკაციების განყოფილება დაფიდან და გადადით ქვემოთ კლიენტის სერთიფიკატების განყოფილებისკენ, რომ ნახოთ კლიენტის ID და კლიენტის საიდუმლო დეტალები.

კლიენტის რწმუნებათა სიგელები

სურათი 3: - კლიენტის სერთიფიკატები Aspose.Cloud დაფაზე.

HTML-დან XPS-მდე C#-ში

ამ განყოფილებაში ჩვენ განვიხილავთ HTML ფაილების XPS ფორმატში გადაქცევას შემდეგი ორი სცენარისთვის.

ჩატვირთეთ HTML Cloud Storage-დან

გთხოვთ, მიჰყვეთ ქვემოთ მოცემულ ინსტრუქციას, რომ ატვირთოთ HTML ფაილი Cloud საცავში და შემდეგ განახორციელოთ კონვერტაცია XPS ფორმატში.

  • უპირველეს ყოვლისა, გთხოვთ, შექმნათ HtmlApi ეგზემპლარი ClientID და ClientSecret დეტალების არგუმენტებად გადაცემისას.
  • მეორეც, წაიკითხეთ HTML ფაილი File.OpenRead(…) მეთოდის გამოყენებით.
  • მესამე, შექმენით StorageApi-ს ეგზემპლარი და გამოიყენეთ UploadFile(…) მეთოდი HTML ფაილის Cloud საცავში ატვირთვისთვის.
  • დაბოლოს, გამოიძახეთ PutConvertDocumentToXps(…) მეთოდი HTML-ში XPS კონვერტაციის შესასრულებლად და შედეგად მიღებული XPS Cloud-ში შესანახად.
// მიიღეთ ClientID https://dashboard.aspose.cloud/-დან
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// საბაზისო URL სტრიქონი
const string SERVICE_API_HOST = "https://api.aspose.cloud";

// შექმენით HtmlApi ეგზემპლარი
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret,SERVICE_API_HOST);

String name = "inputHTML.html";// inpit Document name.
int width = 800; // Resulting image width.
int height = 1000; // Resulting image height.
int leftMargin = 10; // Left resulting image margin.
int rightMargin = 10; // Right resulting image margin.
int topMargin = 10; // Top resulting image margin.
int bottomMargin = 10; // Bottom resulting image margin.

// შედეგად მიღებული ფაილის სახელი
string resultantFile = "Resultant.xps";

try
{
    // ჩატვირთეთ ფაილი ადგილობრივი დისკიდან
    using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
    {
        // შექმენით StorageApi ეგზემპლარი
        var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
        
        // ატვირთეთ HTML ფაილი Cloud საცავში
        uploadFileRequest.UploadFile(file, "inputHTML.html");
    }
    
    // შეასრულეთ კონვერტაცია PDF ფორმატში
    // შეინახეთ გამომავალი Cloud საცავში
    AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
    name, resultantFile, width, height,
    leftMargin, rightMargin, topMargin, bottomMargin);
    
    // წარმატებული შეტყობინების დაბეჭდვა, თუ კონვერტაცია წარმატებულია
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("HTML successfully converted to XPS !");
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
წარწერა

Image 4:- HTML to XPS conversion preview.

ტესტირების მიზნით, შეყვანის HTML და შედეგიანი XPS შეიძლება ჩამოიტვირთოს inputHTML.html-დან და Resultant.xps-დან.

გადაიყვანეთ HTML XPS-ში cURL-ის გამოყენებით

ვინაიდან ჩვენი API შემუშავებულია REST არქიტექტურის მიხედვით, ამიტომ მათზე წვდომა ასევე შესაძლებელია cURL ბრძანებების საშუალებით. ამ განყოფილებაში ჩვენ განვიხილავთ HTML გვერდის XPS ფორმატში გადაქცევას cURL ბრძანების გამოყენებით. მაგრამ სანამ შემდგომ გავაგრძელებთ, პირველი ნაბიჯი არის შექმნათ JSON Web Token (JWT) კლიენტის სერთიფიკატების საფუძველზე Aspose.Cloud dashboard-დან. გთხოვთ, მიჰყევით ქვემოთ მოცემულ ნაბიჯებს HTML-ში XPS-ის კონვერტაციის შესასრულებლად.

  1. მიიღეთ თქვენი კლიენტის ID და კლიენტის საიდუმლო Cloud-ის დაფიდან.
  2. მიიღეთ JSON Web Access Token კლიენტის სერთიფიკატების საფუძველზე.
  3. დარეკეთ PutConvertDocumentToXps API.
  4. შედეგად მიღებული PDF ფაილი შეინახება Cloud საცავში.

გთხოვთ, შეასრულოთ შემდეგი cURL ბრძანება JWT წვდომის ნიშნის გენერირებისთვის.

 curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

გთხოვთ, შეასრულოთ შემდეგი ბრძანება HTML ფაილების Cloud საცავში ატვირთვისთვის:

curl -X PUT "https://api.aspose.cloud/html/storage/file/inputHTML.html" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"File":{}}

მას შემდეგ, რაც HTML აიტვირთება Cloud საცავში, შემდეგი ბრძანება შეიძლება გამოყენებულ იქნას HTML-ში XPS კონვერტაციის შესასრულებლად და შედეგად მიღებული ფაილის Cloud საცავში შესანახად.

curl -X PUT "https://api.aspose.cloud/html/inputHTML.html/convert/xps?outPath=converted.xps&width=800&height=1000&leftMargin=10&rightMargin=10&topMargin=10&bottomMargin=10" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

უფასო XPS Viewer

XPS ფაილის სანახავად, შეგიძლიათ გამოიყენოთ XPS Viewer App. ის შემუშავებულია REST API-ების თავზე და საშუალებას გაძლევთ განიცადოთ API-ის საოცარი შესაძლებლობები.

დასკვნა

ჩვენ გამოვიკვლიეთ Aspose.HTML Cloud-ის შესაძლებლობები HTML ფაილების ფიქსირებულ განლაგებაზე და სხვა რასტრულ სურათებზე გადასაყვანად. ჩვენ შევისწავლეთ HTML-ის კონვერტაციის ფუნქციები C# .NET კოდის ფრაგმენტის გამოყენებით, ასევე cURL ბრძანებების გამოყენებით.

მიუხედავად ამისა, Aspose.HTML Cloud SDK .NET-ისთვის, რომელიც ასახავს Aspose.HTML Cloud-ს, შემუშავებულია MIT ლიცენზიით, ამიტომ კოდის სრული ფრაგმენტის ჩამოტვირთვა შესაძლებელია GitHub-დან. თუ რაიმე პრობლემას წააწყდებით API-ს გამოყენებისას, გთხოვთ, მოგერიდებათ დაგვიკავშირდეთ [პროდუქტის მხარდაჭერის უფასო ფორუმის] მეშვეობით 22.

დაკავშირებული სტატიები

ჩვენ გირჩევთ ეწვიოთ შემდეგ ბმულებს მეტის გასაგებად