C# dilinde REST API kullanarak Word Belgelerine Filigran Ekleyin

Bulutta programlı olarak Word belgelerinize filigran olarak bir metin veya resim ekleyebilirsiniz. Filigranlar, belgenin yaratıcısını veya telif hakkı veya logo gibi diğer bilgileri tanımlamak için kullanılır. Filigran genellikle üst üste bindirilmiş bir görüntü, logo, desen veya belgenin içine yerleştirilmiş metin şeklinde kullanılır. Bu makalede, C# dilinde bir REST API kullanarak Word belgelerine filigran eklemeyi öğreneceksiniz.

Bu yazıda aşağıdaki konular ele alınacaktır:

Filigran REST API ve .NET SDK

DOCX dosyalarına metin veya resim filigranı eklemek için GroupDocs.Watermark Cloud]2 API’sinin [.NET SDK’sını kullanacağım. PDF, Microsoft Word ve Powerpoint gibi desteklenen dosya biçimlerindeki resimlerden ve belgelerden programlı olarak filigran eklemenize, kaldırmanıza, aramanıza ve değiştirmenize olanak tanır. Ayrıca, ihtiyaçlarınıza göre metin stilini, yazı tipini, boyutunu, rengini veya konumunu belirterek filigranların özelleştirilmesini kontrol edebilirsiniz. Şu anda, Bulut API’si için Java SDK da sağlamaktadır.

GroupDocs.Watermark Cloud’u Visual Studio projenize NuGet Paket Yöneticisinden veya Paket Yöneticisi konsolunda aşağıdaki komutu kullanarak yükleyebilirsiniz:

Install-Package GroupDocs.Watermark-Cloud

Lütfen belirtilen adımları izlemeden önce Müşteri Kimliğinizi ve Sırrınızı kontrol panelinden alın. Kimliğinizi ve sırrınızı aldıktan sonra, kodu aşağıda gösterildiği gibi ekleyin:

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

C# dilinde REST API kullanarak Word Belgelerine Metin Filigranı Ekleyin

Aşağıda belirtilen basit adımları izleyerek herhangi bir metni program aracılığıyla Word belgelerinize filigran olarak ekleyebilirsiniz:

Belgeyi Yükle

Öncelikle aşağıda verilen kod örneğini kullanarak Word belgesini Buluta yükleyin:

// api'yi başlat
var fileApi = new FileApi(configuration);

// açık dosya
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

// dosya yükleme isteği oluştur
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// dosya yükleme
fileApi.UploadFile(request);
fileStream.Close();

Sonuç olarak, DOCX dosyası bulut depolama alanına yüklenecek ve kontrol panelinizin dosyalar bölümünde mevcut olacaktır.

C# kullanarak DOCX’e Metin Filigranı Ekleme

Aşağıda verilen adımları izleyerek DOCX dosyasına programlı olarak bir metin filigranı ekleyebilirsiniz.

  • WatermarkApi’nin bir örneğini oluşturun
  • FileInfo örneğini oluşturun
  • DOCX dosya yolunu ayarlayın
  • WatermarkOptions oluşturun ve FileInfo’yu ayarlayın
  • Metin Filigranı Oluşturma Seçenekleri
  • Metin, Yazı Tipi Ailesi, Yazı Tipi Boyutu ve Metin Hizalamasını Ayarlama
  • Filigran metninin Ön plan rengini ayarla
  • Filigran Konumunu tanımlayın
  • WatermarkDetails’i tanımlayın ve TextWatermarkOptions ve Position’ı ayarlayın
  • WatermarkOptions ile AddRequest oluşturun
  • WatermarkApi.add() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, C# dilinde REST API kullanarak bir Word belgesine filigran olarak nasıl metin ekleneceğini gösterir.

// api'yi başlat
var apiInstance = new WatermarkApi(configuration);

// giriş dosyası yolu
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// filigran seçenekleri oluştur
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // filigran ayrıntılarını tanımla
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // metin filigranı tanımla
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // filigran konumunu ayarla
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// ekleme isteği oluştur
var request = new AddRequest(options);

// filigran ekle
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
C# dilinde REST API kullanarak Word Belgelerine Metin Filigranı Ekleyin

C# dilinde REST API kullanarak Word Belgelerine Metin Filigranı Ekleyin

Güncellenmiş Dosyayı İndirin

Yukarıdaki kod örneği, Word dosyasını bulutta bir metin filigranı ile kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:

// api'yi başlat
var fileApi = new FileApi(configuration);

// bulutta varsayılan dosya yolu
var file = "watermark/added_watermark/sample_docx/sample.docx";

// indirme dosyası isteği oluştur
var downloadRequest = new DownloadFileRequest(file, myStorage);

// dosyayı indir
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// dosyayı çalışma dizinine kaydet
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

REST API kullanarak Word Belgelerine Görüntü Filigranı Ekleyin

Aşağıda verilen adımları izleyerek programlı olarak Word belgelerinize filigran olarak bir resim veya logo ekleyebilirsiniz.

  • WatermarkApi’nin bir örneğini oluşturun
  • FileInfo örneğini oluşturun
  • DOCX dosya yolunu ayarlayın
  • WatermarkOptions oluşturun ve FileInfo’yu ayarlayın
  • ImageWatermarkOptions Oluştur
  • Bir PNG görüntüsünün FilePath’ini filigran olarak ayarlayın
  • Filigran Konumunu tanımlayın
  • Filigran Ayrıntıları Oluştur
  • ImageWatermarkOptions ve Position’ı ayarlayın
  • Filigran Ayrıntılarını Listeye Ayarla
  • WatermarkOptions ile AddRequest oluşturun
  • WatermarkApi.add() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, C# dilinde bir REST API kullanarak bir görüntünün DOCX’e filigran olarak nasıl ekleneceğini gösterir. Dosyaları yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

// api'yi başlat
var apiInstance = new WatermarkApi(configuration);

// giriş dosyası yolu
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// filigran seçenekleri oluştur
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // filigran ayrıntılarını tanımla
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // görüntü filigranını tanımla
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // filigran konumunu ayarla
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// ekleme isteği oluştur
var request = new AddRequest(options);

// filigran ekle
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);
C# dilinde REST API kullanarak Görüntülere Görüntü Filigranı ekleyin

C# dilinde REST API kullanarak Word Belgelerine Görüntü Filigranı Ekleyin

Çevrimiçi Deneyin

Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi Filigran aracını deneyin. https://products.groupdocs.app/watermark/docx

Çözüm

Sonuç olarak, bulutta bir Word belgesine metin veya resim filigranı eklemeyi öğrendiniz. DOCX dosyalarını programlı olarak buluta nasıl yükleyeceğinizi ve ardından güncellenmiş dosyayı buluttan nasıl indireceğinizi de öğrendiniz. Belgelerden GroupDocs.Watermark Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla görselleştirmenize ve bunlarla etkileşimde bulunmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda destek ile iletişime geçmekten çekinmeyin.

Ayrıca bakınız