HTML’yi C# .NET’te XPS’e nasıl dönüştürebilirim?
HTML dosyası, bilgi paylaşımı için internet üzerinden yaygın olarak kullanılır. Platformların çoğunluğu tarafından desteklendiği ve neredeyse tüm web tarayıcıları bu formatı yükleyebildiği için, kabul edilebilir formatlardan biri haline gelir. Ancak, yaygın kabul görmesi nedeniyle, birçok bilgisayar korsanı HTML dosyalarının içine kötü amaçlı komut dosyaları yerleştirmeye çalışır. Kötü amaçlı HTML ve JavaScript kodunun yüksek profilli saldırıları, son yıllarda hem farkındalıkta hem de istismarda önemli bir artış gördü. Diğer yandan, XPS dosyası, XML Paper Specifications’a dayalı sayfa düzeni dosyalarını temsil eder.
- XPS, PDF dosya biçimine benzer ancak bir belgenin düzeni, görünümü ve yazdırma bilgilerinde XML kullanır.
HTML Dönüştürme API’si
Aspose.HTML Cloud, HTML dosyalarını işleme yeteneklerini sağlamak için özel olarak tasarlanmıştır. Giriş HTML’inin yanı sıra, XHTML, MHTML, EPUB, Markdown veya bir Web sayfasını URL’sine göre de yükleyebiliriz. Ortaya çıkan çıktı PDF, XPS, DOCX veya raster görüntü biçimleri olabilir: JPEG, PNG, TIFF, BMP, GIF. API, REST mimarisine göre geliştirildiğinden Masaüstü, Mobil, Web ve Hibrit uygulamaların yanı sıra masaüstü veya mobil platformlarda da kullanılabilir.
Müşterilerimize daha fazla kolaylık sağlamak için programlama diline özgü SDK’lar oluşturduk. Cloud SDK’ları, çeşitli programlama dillerindeki REST API’lerinin etrafına sarmalayıcılar olarak belgeleri istediğiniz dilde işlemenize olanak tanır. Bu şekilde, güçlü türlerin ve IDE vurgularının tüm avantajlarından hızlı ve kolay bir şekilde yararlanabilirsiniz. Kısa sürede başlamanız için lütfen SDK’lar ve çalışan örnekler için Aspose.HTML GitHub deposunu kontrol edin. Bu makalede, Aspose.HTML Cloud SDK for .NET‘in belge dönüştürme özelliklerini tartışacağız.
Kurulum
Cloud SDK’yı kullanmaya başlamak için ilk adım, onu sisteme kurmaktır. SDK NuGet ve GitHub üzerinden kullanılabilir. NuGet için kurulumu gerçekleştirmek üzere lütfen terminal penceresinde aşağıdaki komutu yürütün
nuget install Aspose.HTML-Cloud
SDK’yi kurmanın bir diğer yolu da Visual Studio içindeki Paket Yöneticisi Konsolu’dur. Lütfen aşağıdaki komutu çalıştırın:
PM> Install-Package Aspose.HTML-Cloud
Resim 1:- Aspose.HTML NuGet paketi kuruldu.
NuGet Paket Yöneticisi
Bir diğer kolay yaklaşım ise SDK’yı Visual Studio IDE içindeki NuGet Paket Yöneticisi aracılığıyla yüklemektir.
- Çözüm Gezgini’ni açın.
- Projeyi genişletin ve çözümünüz içindeki Paketler klasörüne sağ tıklayın.
- NuGet Paketlerini Yönet… seçeneğini belirleyin.
- Gözat sekmesine tıklayın ve “Aspose.HTML-Cloud” ifadesini arayın.
- Aspose.HTML-Cloud paketine tıklayın, sağ sekmede uygun sürümü seçin ve Paket Ekle butonuna tıklayın.
Ücretsiz Cloud Aboneliği
Bir sonraki önemli adım, Aspose.Cloud panosunda ücretsiz bir hesap aboneliğidir. Kredi kartı veya başka ödeme bilgileri gerekmez. Bir GitHub veya Google hesabınız varsa, sadece Kaydolun veya yeni bir hesap oluştur düğmesine tıklayın ve gerekli bilgileri sağlayın. Şimdi kimlik bilgilerini kullanarak panoya giriş yapın ve panodan Uygulamalar bölümünü genişletin ve İstemci Kimliği ve İstemci Gizli Bilgisi ayrıntılarını görmek için İstemci Kimlik Bilgileri bölümüne doğru aşağı kaydırın.
Resim 3:- Aspose.Cloud panosundaki İstemci Kimlik Bilgileri.
C# ile HTML’den XPS’e
Bu bölümde, aşağıdaki iki senaryo için HTML dosyalarının XPS formatına dönüştürülmesini ele alacağız.
Cloud Depolamadan HTML Yükle
Lütfen aşağıdaki talimatları izleyerek HTML dosyasını Cloud depolamaya yükleyin ve ardından XPS formatına dönüştürün.
- Öncelikle ClientID ve ClientSecret detaylarını argüman olarak vererek HtmlApi örneği oluşturun.
- İkinci olarak, File.OpenRead(…) metodunu kullanarak HTML dosyasını okuyun.
- Üçüncüsü, StorageApi’nin bir örneğini oluşturun ve HTML dosyasını Cloud depolamasına yüklemek için UploadFile(…) yöntemini kullanın.
- Son olarak, HTML’den XPS’e dönüştürme işlemini gerçekleştirmek ve ortaya çıkan XPS’i Cloud depolamasına kaydetmek için PutConvertDocumentToXps(…) yöntemini çağırın.
// ClientID'yi https://dashboard.aspose.cloud/ adresinden alın
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// temel URL dizesi
const string SERVICE_API_HOST = "https://api.aspose.cloud";
// HtmlApi örneği oluştur
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.
// sonuç dosyasının adı
string resultantFile = "Resultant.xps";
try
{
// dosyayı yerel sürücüden yükle
using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
{
// StorageApi örneği oluşturun
var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
// HTML dosyasını Cloud depolama alanına yükleyin
uploadFileRequest.UploadFile(file, "inputHTML.html");
}
// PDF formatına dönüştürmeyi gerçekleştirin
// çıktıyı Cloud depolama alanına kaydet
AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
name, resultantFile, width, height,
leftMargin, rightMargin, topMargin, bottomMargin);
// dönüşüm başarılı olursa başarı mesajını yazdır
if (response != null && response.Equals("OK"))
{
Console.WriteLine("HTML successfully converted to XPS !");
}
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
Test amaçlı olarak, giriş HTML’si ve ortaya çıkan XPS inputHTML.html ve Resultant.xps adreslerinden indirilebilir.
HTML’yi cURL kullanarak XPS’e dönüştürün
API’lerimiz REST mimarisine göre geliştirildiğinden, cURL komutları aracılığıyla da erişilebilirler. Bu bölümde, cURL komutunu kullanarak HTML sayfasının XPS biçimine dönüştürülmesini ele alacağız. Ancak daha fazla ilerlemeden önce, ilk adım Aspose.Cloud panosundan istemci kimlik bilgilerine dayalı JSON Web Token (JWT) oluşturmaktır. HTML’den XPS’e dönüştürmeyi gerçekleştirmek için lütfen aşağıda verilen adımları izleyin.
- İstemci Kimliğinizi ve İstemci Gizli Anahtarınızı Cloud panosundan alın.
- İstemci kimlik bilgilerine dayalı JSON Web Erişim Belirtecini alın.
- PutConvertDocumentToXps API’sini çağırın.
- Elde edilen PDF dosyası Cloud depolama alanına kaydedilecektir.
JWT erişim belirtecini oluşturmak için lütfen aşağıdaki cURL komutunu çalıştırın.
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 dosyalarını Cloud depolamaya yüklemek için lütfen aşağıdaki komutu çalıştırın:
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 bulut depolama alanına yüklendikten sonra, HTML’i XPS’e dönüştürmek ve ortaya çıkan dosyayı bulut depolama alanına kaydetmek için aşağıdaki komut kullanılabilir.
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>"
Ücretsiz XPS Görüntüleyici
XPS dosyasını görüntülemek için XPS Viewer App kullanmayı düşünebilirsiniz. Bu, REST API’lerinin üzerinde geliştirilmiştir ve API’nin inanılmaz yeteneklerini deneyimlemenizi sağlar.
Çözüm
HTML dosyalarının sabit sayfa düzeni ve diğer raster görüntülere dönüştürülmesi için Aspose.HTML Cloud yeteneklerini inceledik. HTML’yi C# .NET kod parçacığını ve cURL komutlarını kullanarak dönüştürme özelliklerini inceledik.
Bununla birlikte, Aspose.HTML Cloud’un etrafında bir sarmalayıcı olan Aspose.HTML Cloud SDK for .NET, MIT lisansı altında geliştirilmiştir, bu nedenle tam kod parçacığı GitHub adresinden indirilebilir. API’yi kullanırken herhangi bir sorunla karşılaşırsanız, lütfen ücretsiz ürün destek forumu aracılığıyla bizimle iletişime geçmekten çekinmeyin.
İlgili makaleler
Daha fazla bilgi edinmek için aşağıdaki bağlantıları ziyaret etmenizi öneririz