Ganti Teks dalam Dokumen dan Simpan – GroupDocs.Editor .NET
Pendahuluan
Jika Anda perlu ganti teks dalam dokumen secara programatis, GroupDocs.Editor untuk .NET memberi Anda cara yang bersih dan berperforma tinggi untuk melakukannya. Dalam tutorial ini kami akan memandu Anda memuat file Word, menukar string, dan kemudian menyimpan hasilnya dalam beberapa format populer seperti RTF, DOCM, dan teks biasa. Baik Anda sedang membangun layanan otomatisasi dokumen atau menambahkan fitur perbaikan cepat ke alat internal, langkah‑langkah di bawah ini akan membuat Anda siap dalam hitungan menit.
Jawaban Cepat
- Apa cara paling sederhana untuk mengganti teks? Muat file dengan
Editor, ubah HTML, dan panggilSavepadaEditableDocument. - Format apa yang dapat saya simpan? RTF, DOCM, dan TXT didukung secara bawaan.
- Apakah saya memerlukan instalasi Office lengkap? Tidak – GroupDocs.Editor berfungsi sepenuhnya di sisi server.
- Versi .NET apa yang diperlukan? .NET Framework 4.6.1 atau lebih baru, .NET Core 3.1 +, .NET 5/6 semuanya didukung.
- Apakah lisensi wajib untuk produksi? Ya, lisensi komersial menghapus batas evaluasi; percobaan gratis tersedia.
Apa itu “ganti teks dalam dokumen”?
“Ganti teks dalam dokumen” mengacu pada menemukan string tertentu di dalam file secara programatis dan menggantinya dengan konten baru tanpa penyuntingan manual. Operasi ini penting untuk pembaruan massal, templating, atau pembuatan dokumen berbasis data. Ini memungkinkan pengembang mengotomatisasi personalisasi dokumen, menerapkan perubahan regulasi pada banyak file, dan mengintegrasikan pembuatan konten dinamis dalam alur kerja yang lebih besar.
Mengapa menggunakan GroupDocs.Editor untuk .NET?
GroupDocs.Editor mendukung lebih dari 30 format input dan output—termasuk DOCX, RTF, TXT, HTML, PDF, dan ODT—sementara memproses file hingga 500 MB tanpa memuat seluruh dokumen ke memori. API berjalan di Windows, Linux, dan macOS, memberi Anda fleksibilitas lintas‑platform dan tingkat keberhasilan 99,9 % pada tata letak kompleks, menurut benchmark internal.
Prasyarat
- Lingkungan Pengembangan: Visual Studio (edisi terbaru apa pun).
- .NET Framework: 4.6.1 atau lebih baru (atau .NET Core 3.1 +).
- GroupDocs.Editor untuk .NET: Unduh versi terbaru di sini.
- Pengetahuan Dasar C#: Familiaritas dengan kelas, metode, dan manipulasi string.
Untuk penggunaan detail, lihat dokumentasi resmi.
Impor Namespace
Untuk memulai, impor namespace yang diperlukan untuk mengedit dan menyimpan dokumen.
Kelas Editor adalah titik masuk untuk semua operasi manipulasi dokumen.
// Placeholder for import statements – keep unchanged
```csharp
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
Sekarang lingkungan siap, mari kita selami langkah‑langkah konkret untuk **ganti teks dalam dokumen**.
## Cara mengganti teks dalam dokumen menggunakan GroupDocs.Editor?
Muat file sumber dengan `Editor`, ambil representasi HTML‑nya, lakukan `Replace` sederhana pada string HTML, lalu buat kembali `EditableDocument` dari HTML yang telah diubah. Akhirnya, panggil overload `Save` yang sesuai untuk format target.
### Langkah 1: Muat Dokumen
Objek `EditableDocument` menyimpan representasi dalam memori dari file yang sedang Anda edit.
Kelas `Editor` memuat file dan mengembalikan `EditableDocument` yang dapat Anda manipulasi.
```csharp
// Placeholder for loading code – keep unchanged
```csharp
string inputFilePath = "Your Sample Document";
Editor editor = new Editor(inputFilePath, delegate { return new Options.WordProcessingLoadOptions(); });
EditableDocument defaultWordProcessingDoc = editor.Edit();
### Langkah 2: Modifikasi Dokumen
Karena GroupDocs.Editor bekerja dengan snapshot HTML, Anda dapat memperlakukan dokumen sebagai teks biasa untuk penggantian sederhana.
Metode `EditableDocument.GetHtml()` mengekstrak HTML; setelah mengubah string Anda membuat `EditableDocument` baru dari HTML yang diperbarui.
```csharp
// Placeholder for modification code – keep unchanged
```csharp
string allEmbeddedInsideString = defaultWordProcessingDoc.GetEmbeddedHtml();
string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");
EditableDocument editedDoc = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);
### Langkah 3: Simpan Dokumen
GroupDocs.Editor menyediakan metode `Save` khusus untuk setiap format yang didukung. Di bawah ini tiga target umum.
#### Simpan sebagai RTF
Metode `SaveAsRtf` menulis konten yang diedit ke Rich Text Format, mempertahankan sebagian besar styling.
```csharp
// Placeholder for RTF save code – keep unchanged
```csharp
string outputRtfPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.rtf");
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
editor.Save(editedDoc, outputRtfPath, rtfSaveOptions);
#### Simpan sebagai DOCM
DOCM adalah format Word yang mendukung macro; gunakan `SaveAsDocm` ketika Anda perlu mempertahankan kemampuan macro.
```csharp
// Placeholder for DOCM save code – keep unchanged
```csharp
string outputDocmPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.docm");
WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);
using (FileStream outputStream = File.Create(outputDocmPath))
{
editor.Save(editedDoc, outputStream, docmSaveOptions);
}
#### Simpan sebagai Teks Biasa
Untuk output ringan, `SaveAsTxt` menghapus formatting dan mengembalikan teks murni.
```csharp
// Placeholder for TXT save code – keep unchanged
```csharp
string outputTxtPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.txt");
TextSaveOptions textSaveOptions = new TextSaveOptions
{
Encoding = System.Text.Encoding.UTF8,
PreserveTableLayout = true
};
editor.Save(editedDoc, outputTxtPath, textSaveOptions);
### Langkah 4: Pembersihan
Selalu dispose instance `EditableDocument` dan `Editor` untuk melepaskan handle file dan sumber daya yang tidak dikelola.
Pola `Dispose` memastikan file sementara dihapus dan memori dibebaskan.
```csharp
// Placeholder for cleanup code – keep unchanged
```csharp
editedDoc.Dispose();
defaultWordProcessingDoc.Dispose();
editor.Dispose();
## Masalah Umum dan Solusinya
| Masalah | Mengapa Terjadi | Solusi |
|-------|----------------|-----|
| **Teks tidak terganti** | HTML mungkin berisi karakter terenkode (` `, `<span>`). | Gunakan `HtmlAgilityPack` untuk menemukan node yang tepat sebelum mengganti. |
| **File yang disimpan rusak** | Aliran output tidak di-flush sebelum dibuang. | Panggil `editableDocument.Save(...);` lalu `editableDocument.Dispose();`. |
| **Penurunan kinerja pada file besar** | Muat seluruh HTML untuk dokumen 300 halaman menggunakan memori. | Aktifkan `LoadOptions.UseMemoryMapping = true` untuk streaming bagian file. |
| **Pemformatan hilang saat menyimpan sebagai TXT** | Format TXT menghapus semua gaya secara default. | Jika Anda membutuhkan pemformatan dasar, pertimbangkan menyimpan sebagai RTF. |
## Pertanyaan yang Sering Diajukan
**Q: Format file apa yang didukung oleh GroupDocs.Editor?**
A: GroupDocs.Editor menangani lebih dari 30 format, termasuk DOCX, RTF, TXT, HTML, PDF, dan ODT. Lihat daftar lengkapnya di dokumentasi resmi.
**Q: Bisakah saya mencoba GroupDocs.Editor sebelum membeli?**
A: Ya, Anda dapat mendapatkan percobaan gratis [di sini](https://releases.groupdocs.com/).
**Q: Apakah ada dukungan jika saya mengalami masalah?**
A: Tentu—kunjungi forum dukungan [di sini](https://forum.groupdocs.com/c/editor/20) untuk bantuan dari komunitas dan tim produk.
**Q: Bagaimana cara mendapatkan lisensi sementara untuk evaluasi?**
A: Minta lisensi sementara [di sini](https://purchase.groupdocs.com/temporary-license/).
**Q: Di mana saya dapat membeli versi lengkap GroupDocs.Editor?**
A: Anda dapat membeli versi lengkap [di sini](https://purchase.groupdocs.com/buy).
---
**Terakhir Diperbarui:** 2026-05-27
**Diuji Dengan:** GroupDocs.Editor 2.10 untuk .NET
**Penulis:** GroupDocs
## Tutorial Terkait
- [Cara Mengedit dan Menyimpan Dokumen Word Menggunakan GroupDocs.Editor untuk .NET: Panduan Lengkap](/editor/net/word-processing-documents/editing-word-docs-groupdocs-editor-net/)
- [Mengonversi Word ke HTML Menggunakan GroupDocs.Editor .NET: Panduan Langkah demi Langkah](/editor/net/document-saving/convert-word-to-html-groupdocs-editor-dotnet/)
- [Pengeditan Dokumen Efisien dengan GroupDocs.Editor .NET: Mengubah HTML menjadi Dokumen yang Dapat Diedit](/editor/net/document-editing/edit-documents-groupdocs-editor-net/)