Wywołanie zwrotne dzielenia wyrazów

Wstęp

Cześć! Czy kiedykolwiek znalazłeś się w pułapce zawiłości formatowania tekstu, zwłaszcza w przypadku języków wymagających dzielenia wyrazów? Nie jesteś sam. Dzielenie wyrazów, choć kluczowe dla prawidłowego układu tekstu, może być trochę uciążliwe. Ale zgadnij co? Aspose.Words dla .NET ma dla Ciebie wsparcie. Ta potężna biblioteka umożliwia bezproblemowe zarządzanie formatowaniem tekstu, w tym obsługę dzielenia wyrazów za pomocą mechanizmu wywołania zwrotnego. Zaintrygowany? Zanurzmy się w szczegółach, jak możesz zaimplementować wywołanie zwrotne dzielenia wyrazów za pomocą Aspose.Words dla .NET.

Wymagania wstępne

Zanim zaczniemy pisać kod, upewnijmy się, że masz wszystko, czego potrzebujesz:

  1. Aspose.Words dla .NET: Upewnij się, że masz bibliotekę. Możeszpobierz tutaj.
  2. IDE: Środowisko programistyczne podobne do Visual Studio.
  3. Podstawowa wiedza o języku C#: zrozumienie języka C# i platformy .NET.
  4. Słowniki dzielenia wyrazów: słowniki dzielenia wyrazów dla języków, których planujesz używać.
  5. Licencja Aspose: Ważna licencja Aspose. Możesz uzyskaćlicencja tymczasowa jeśli nie masz.

Importuj przestrzenie nazw

Po pierwsze, zaimportujmy niezbędne przestrzenie nazw. Dzięki temu nasz kod będzie miał dostęp do wszystkich klas i metod, których potrzebujemy z Aspose.Words.

using Aspose.Words;
using System;
using System.IO;

Krok 1: Zarejestruj wywołanie zwrotne dzielenia wyrazów

Na początek musimy zarejestrować nasze wywołanie zwrotne dzielenia wyrazów. W tym miejscu mówimy Aspose.Words, aby używał naszej niestandardowej logiki dzielenia wyrazów.

try
{
    // Zarejestruj wywołanie zwrotne dzielenia wyrazów.
    Hyphenation.Callback = new CustomHyphenationCallback();
}
catch (Exception e)
{
    Console.WriteLine($"Error registering hyphenation callback: {e.Message}");
}

Tutaj tworzymy wystąpienie naszego niestandardowego wywołania zwrotnego i przypisujemy je doHyphenation.Callback.

Krok 2: Zdefiniuj ścieżkę dokumentu

Następnie musimy zdefiniować katalog, w którym przechowywane są nasze dokumenty. Jest to kluczowe, ponieważ będziemy ładować i zapisywać dokumenty z tej ścieżki.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Zastępować"YOUR DOCUMENT DIRECTORY" z rzeczywistą ścieżką do Twoich dokumentów.

Krok 3: Załaduj dokument

Teraz wczytajmy dokument, który wymaga podziału wyrazów.

Document document = new Document(dataDir + "German text.docx");

Tutaj ładujemy niemiecki dokument tekstowy. Możesz zastąpić"German text.docx" z nazwą pliku Twojego dokumentu.

Krok 4: Zapisz dokument

Po załadowaniu dokumentu zapisujemy go do nowego pliku, stosując w tym procesie funkcję zwrotną dzielenia wyrazów.

document.Save(dataDir + "TreatmentByCesureWithRecall.pdf");

Ten wiersz zapisuje dokument w formacie PDF z zastosowanym dzieleniem wyrazów.

Krok 5: Obsługa wyjątku słownika brakującego podziału wyrazów

Czasami możesz napotkać problem braku słownika dywizów. Zajmijmy się tym.

catch (Exception e) when (e.Message.StartsWith("Missing hyphenation dictionary"))
{
    Console.WriteLine(e.Message);
}
finally
{
    Hyphenation.Callback = null;
}

W tym bloku wychwytujemy konkretny wyjątek związany z brakującymi słownikami i wyświetlamy komunikat.

Krok 6: Implementacja niestandardowej klasy wywołania zwrotnego dzielenia wyrazów

Teraz wdrożymyCustomHyphenationCallback klasa, która obsługuje żądania słowników dzielenia wyrazów.

public class CustomHyphenationCallback : IHyphenationCallback
{
    public void RequestDictionary(string language)
    {
        string dictionaryFolder = MyDir;
        string dictionaryFullFileName;
        switch (language)
        {
            case "en-US":
                dictionaryFullFileName = Path.Combine(dictionaryFolder, "hyph_en_US.dic");
                break;
            case "de-CH":
                dictionaryFullFileName = Path.Combine(dictionaryFolder, "hyph_de_CH.dic");
                break;
            default:
                throw new Exception($"Missing hyphenation dictionary for {language}.");
        }
        // Zarejestruj słownik dla żądanego języka.
        Hyphenation.RegisterDictionary(language, dictionaryFullFileName);
    }
}

W tej klasieRequestDictionary Metoda jest wywoływana zawsze, gdy potrzebny jest słownik łącznikowy. Sprawdza język i rejestruje odpowiedni słownik.

Wniosek

masz to! Właśnie nauczyłeś się, jak zaimplementować wywołanie zwrotne dzielenia wyrazów w Aspose.Words dla .NET. Postępując zgodnie z tymi krokami, możesz mieć pewność, że Twoje dokumenty będą pięknie sformatowane, niezależnie od języka. Niezależnie od tego, czy masz do czynienia z językiem angielskim, niemieckim czy jakimkolwiek innym, ta metoda pozwala Ci bez wysiłku obsługiwać dzielenie wyrazów.

Najczęściej zadawane pytania

Czym jest Aspose.Words dla .NET?

Aspose.Words for .NET to zaawansowana biblioteka do manipulowania dokumentami, która umożliwia programistom programowe tworzenie, modyfikowanie i konwertowanie dokumentów.

Dlaczego dzielenie wyrazów jest ważne w formatowaniu dokumentów?

Funkcja dzielenia wyrazów poprawia układ tekstu, dzieląc słowa w odpowiednich miejscach, co zapewnia bardziej czytelny i atrakcyjny wizualnie dokument.

Czy mogę używać Aspose.Words za darmo?

Aspose.Words oferuje bezpłatną wersję próbną. Możesz ją otrzymaćTutaj.

Jak zdobyć słownik dzielenia wyrazów?

Możesz pobrać słowniki dzielenia wyrazów z różnych źródeł online lub, jeśli zajdzie taka potrzeba, utworzyć swój własny.

Co się stanie, jeśli brakuje słownika dzielenia wyrazów?

Jeśli brakuje słownika,RequestDictionaryMetoda zgłasza wyjątek, który można obsłużyć, informując o nim użytkownika lub zapewniając rozwiązanie awaryjne.