Sử dụng Bảng tác vụ của Tiện ích mở rộng Web

Giới thiệu

Chào mừng bạn đến với hướng dẫn chuyên sâu này về cách sử dụng Web Extension Task Panes trong tài liệu Word bằng Aspose.Words cho .NET. Nếu bạn từng muốn cải thiện tài liệu Word của mình bằng các ngăn tác vụ tương tác, bạn đã đến đúng nơi rồi. Hướng dẫn này sẽ hướng dẫn bạn từng bước để đạt được điều này một cách liền mạch.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo rằng bạn có mọi thứ cần thiết:

  • Aspose.Words cho .NET: Bạn có thể tải xuốngđây.
  • Môi trường phát triển .NET: Visual Studio hoặc bất kỳ IDE nào khác mà bạn thích.
  • Kiến thức cơ bản về C#: Điều này sẽ giúp bạn theo dõi các ví dụ về mã.
  • Giấy phép cho Aspose.Words: Bạn có thể mua mộtđây hoặc xin giấy phép tạm thờiđây.

Nhập không gian tên

Trước khi bắt đầu viết mã, hãy đảm bảo bạn đã nhập các không gian tên sau vào dự án của mình:

using Aspose.Words;
using Aspose.Words.WebExtensions;

Hướng dẫn từng bước

Bây giờ, chúng ta hãy chia nhỏ quy trình thành các bước dễ thực hiện.

Bước 1: Thiết lập thư mục tài liệu của bạn

Trước tiên, chúng ta cần thiết lập đường dẫn đến thư mục tài liệu của bạn. Đây là nơi tài liệu Word của bạn sẽ được lưu.

// Đường dẫn đến thư mục tài liệu.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Thay thế"YOUR DOCUMENT DIRECTORY" bằng đường dẫn thực tế đến thư mục tài liệu của bạn.

Bước 2: Tạo một tài liệu mới

Tiếp theo, chúng ta sẽ tạo một tài liệu Word mới bằng Aspose.Words.

Document doc = new Document();

Dòng này khởi tạo một phiên bản mới củaDocument lớp biểu diễn một tài liệu Word.

Bước 3: Thêm ngăn tác vụ

Bây giờ, chúng ta sẽ thêm Task Pane vào tài liệu của mình. Task Pane hữu ích trong việc cung cấp các chức năng và công cụ bổ sung trong tài liệu Word.

TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);

Ở đây, chúng ta tạo ra một cái mớiTaskPane đối tượng và thêm nó vào tài liệuWebExtensionTaskPanes bộ sưu tập.

Bước 4: Cấu hình ngăn tác vụ

Để làm cho Ngăn tác vụ của chúng ta hiển thị và thiết lập các thuộc tính của nó, chúng ta sử dụng đoạn mã sau:

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState thiết lập vị trí mà Ngăn tác vụ sẽ xuất hiện. Trong trường hợp này, nó nằm ở bên phải.
  • IsVisible đảm bảo Ngăn tác vụ có thể nhìn thấy được.
  • Width thiết lập chiều rộng của Ngăn tác vụ.

Bước 5: Thiết lập tham chiếu tiện ích mở rộng web

Tiếp theo, chúng tôi thiết lập Tham chiếu tiện ích mở rộng web bao gồm ID, phiên bản, loại cửa hàng và cửa hàng.

taskPane.WebExtension.Reference.Id = "wa102923726";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "th-TH";
  • Idlà mã định danh duy nhất cho tiện ích mở rộng web.
  • Version chỉ rõ phiên bản của phần mở rộng.
  • StoreType biểu thị loại cửa hàng (trong trường hợp này là OMEX).
  • Store chỉ định mã ngôn ngữ/văn hóa của cửa hàng.

Bước 6: Thêm Thuộc tính vào Tiện ích mở rộng Web

Bạn có thể thêm thuộc tính vào tiện ích mở rộng web của mình để xác định hành vi hoặc nội dung của nó.

taskPane.WebExtension.Properties.Add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));

Ở đây, chúng ta thêm một thuộc tính có tênmailchimpCampaign.

Bước 7: Liên kết tiện ích mở rộng web

Cuối cùng, chúng tôi thêm liên kết vào tiện ích mở rộng web của mình. Liên kết cho phép bạn liên kết tiện ích mở rộng với các phần cụ thể của tài liệu.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 là tên của ràng buộc.
  • WebExtensionBindingType.Text cho biết ràng buộc này thuộc loại văn bản.
  • 194740422 là ID của phần tài liệu mà phần mở rộng được liên kết tới.

Bước 8: Lưu tài liệu

Sau khi thiết lập mọi thứ, hãy lưu tài liệu của bạn.

doc.Save(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Dòng này lưu tài liệu vào thư mục được chỉ định với tên tệp đã cho.

Bước 9: Tải và Hiển thị Thông tin Ngăn tác vụ

Để xác minh và hiển thị thông tin ngăn tác vụ, chúng tôi tải tài liệu và lặp lại qua các ngăn tác vụ.

doc = new Document(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Console.WriteLine("Task panes sources:\n");

foreach (TaskPane taskPaneInfo in doc.WebExtensionTaskPanes)
{
    WebExtensionReference reference = taskPaneInfo.WebExtension.Reference;
    Console.WriteLine($"Provider: \"{reference.Store}\", version: \"{reference.Version}\", catalog identifier: \"{reference.Id}\";");
}

Mã này tải tài liệu và in ra nhà cung cấp, phiên bản và mã định danh danh mục của mỗi ngăn tác vụ trong bảng điều khiển.

Phần kết luận

Và thế là xong! Bạn đã thêm và cấu hình thành công Web Extension Task Pane trong tài liệu Word bằng Aspose.Words for .NET. Tính năng mạnh mẽ này có thể cải thiện đáng kể tài liệu Word của bạn bằng cách cung cấp các chức năng bổ sung trực tiếp trong tài liệu.

Câu hỏi thường gặp

Ngăn tác vụ trong Word là gì?

Ngăn tác vụ là một thành phần giao diện cung cấp các công cụ và chức năng bổ sung trong tài liệu Word, nâng cao khả năng tương tác và năng suất của người dùng.

Tôi có thể tùy chỉnh giao diện của Ngăn tác vụ không?

Có, bạn có thể tùy chỉnh giao diện của Ngăn tác vụ bằng cách thiết lập các thuộc tính nhưDockState, IsVisible , VàWidth.

Thuộc tính mở rộng web là gì?

Thuộc tính tiện ích mở rộng web là thuộc tính tùy chỉnh mà bạn có thể thêm vào tiện ích mở rộng web để xác định hành vi hoặc nội dung của tiện ích mở rộng đó.

Làm thế nào để liên kết Tiện ích mở rộng Web với một phần của tài liệu?

Bạn có thể liên kết một Tiện ích mở rộng Web với một phần của tài liệu bằng cách sử dụngWebExtensionBinding lớp, chỉ định loại liên kết và ID mục tiêu.

Tôi có thể tìm thêm thông tin về Aspose.Words cho .NET ở đâu?

Bạn có thể tìm thấy tài liệu chi tiếtđây.