Wywołanie zwrotne dzielenia

Wstęp

Hej tam! Czy kiedykolwiek miałeś trudności z formatowaniem tekstu, szczególnie 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 przyprawiać o ból głowy. Ale zgadnij co? Aspose.Words dla .NET Cię wspiera. Ta potężna biblioteka umożliwia płynne zarządzanie formatowaniem tekstu, w tym obsługę dzielenia wyrazów poprzez mechanizm wywołania zwrotnego. Zaintrygowany? Zanurzmy się w sedno tego, jak zaimplementować wywołanie zwrotne polegające na dzieleniu wyrazów przy użyciu Aspose.Words dla .NET.

Warunki wstępne

Zanim zabrudzimy sobie ręce kodem, upewnijmy się, że mamy wszystko, czego potrzebujemy:

  1. Aspose.Words dla .NET: Upewnij się, że masz bibliotekę. Możeszpobierz go tutaj.
  2. IDE: środowisko programistyczne, takie jak Visual Studio.
  3. Podstawowa znajomość C#: Zrozumienie C# i frameworku .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 zdobyćlicencja tymczasowa jeśli go nie masz.

Importuj przestrzenie nazw

Na początek zaimportujmy niezbędne przestrzenie nazw. Dzięki temu nasz kod ma 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 polegające na dzieleniu wyrazów

Na początek musimy zarejestrować nasze wywołanie zwrotne polegające na dzieleniu 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 instancję naszego niestandardowego wywołania zwrotnego i przypisujemy ją doHyphenation.Callback.

Krok 2: Zdefiniuj ścieżkę dokumentu

Następnie musimy zdefiniować katalog, w którym przechowywane są nasze dokumenty. Jest to o tyle istotne, że będziemy wczytywać i zapisywać dokumenty z tej ścieżki.

string dataDir = "YOUR DOCUMENT DIRECTORY";

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

Krok 3: Załaduj dokument

Teraz załadujmy dokument wymagający dzielenia wyrazów.

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

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

Krok 4: Zapisz dokument

Po wczytaniu dokumentu zapisujemy go do nowego pliku, stosując przy tym funkcję zwrotną dzielenia wyrazów.

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

Ta linia zapisuje dokument jako plik PDF z zastosowanym dzieleniem wyrazów.

Krok 5: Obsłuż wyjątek dotyczący braku słownika dzielenia wyrazów

Czasami możesz napotkać problem polegający na braku słownika dzielenia wyrazó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 przechwytujemy konkretny wyjątek związany z brakującymi słownikami i drukujemy wiadomość.

Krok 6: Zaimplementuj niestandardową klasę wywołania zwrotnego dzielenia wyrazów

Teraz zaimplementujmyCustomHyphenationCallback klasa, która obsługuje żądanie 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, gdy potrzebny jest słownik dzielenia wyrazów. Sprawdza język i rejestruje odpowiedni słownik.

Wniosek

masz to! Właśnie nauczyłeś się, jak zaimplementować wywołanie zwrotne polegające na dzieleniu wyrazów w Aspose.Words dla .NET. Wykonując poniższe kroki, 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 angielskim, niemieckim czy jakimkolwiek innym językiem, ta metoda pozwala bez wysiłku poradzić sobie z dzieleniem wyrazów.

Często zadawane pytania

Co to jest Aspose.Words dla .NET?

Aspose.Words dla .NET to potężna biblioteka do manipulacji dokumentami, która umożliwia programistom programowe tworzenie, modyfikowanie i konwertowanie dokumentów.

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

Dzielenie wyrazów poprawia układ tekstu poprzez dzielenie słów w odpowiednich miejscach, zapewniając bardziej czytelny i atrakcyjny wizualnie dokument.

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

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

Jak uzyskać słownik dzielenia wyrazów?

Możesz pobrać słowniki dzielenia wyrazów z różnych zasobów internetowych lub w razie potrzeby utworzyć własne.

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ć, aby poinformować użytkownika lub zapewnić rozwiązanie awaryjne.