Sự khác biệt giữa phiên bản Python và .NET

Aspose.Words cho Python via .NET là trình bao bọc của Aspose.Words cho .NET, đó là lý do tại sao hai sản phẩm này có bộ tính năng gần như giống nhau. Tuy nhiên, có một số sắc thái trong công việc cũng như sự khác biệt về tính năng và API, được mô tả trên trang này.

Sự khác biệt về tính năng

Do quá trình gói nên có một số tính năng không có trong phiên bản Python. Dưới đây là danh sách các tính năng đáng chú ý nhất hiện chưa có trong phiên bản Python.

• Việc triển khai giao diện chưa được hỗ trợ, đó là lý do tại sao không thể sử dụng các lệnh gọi lại như IWarningCallback, IReplacingCallback, IFieldUpdatingCallback, IFieldMergingCallback, v.v.
• Tính năng in không khả dụng vì phiên bản .NET Standard 2.0 của Aspose.Words được sử dụng làm back-end của phiên bản python, phiên bản này cũng không cung cấp chức năng này.
• Chỉ chức năng Mail Merge đơn giản mới được cung cấp với các mảng tên trường và giá trị trường làm nguồn dữ liệu.
• Hiện không thể triển khai DocumentVisitor từ mã Python.

Truyền đối tượng Aspose.Words trong Python

Mặc dù việc truyền kiểu không phải là điều tự nhiên đối với các nhà phát triển Python, một số tác vụ không thể hoàn thành nếu không truyền các nút hoặc trường tài liệu sang loại cụ thể. Aspose.Words cho Python via .NET cung cấp các phương thức đặc biệt cho phép truyền các đối tượng khi cần thiết.

Nút truyền

Lớp cơ sở cho tất cả các nút tài liệu trong Aspose.Words DOM là lớp Node. Ví dụ, phương thức get_child trả về và thể hiện của lớp Node, nhưng nếu bạn cần sửa đổi nút được trả về, trong hầu hết các trường hợp, bạn nên chuyển nó thành kiểu cụ thể. Đoạn mã sau minh họa cách thay đổi màu phông chữ của Run đầu tiên trong tài liệu:

doc = aw.Document(docs_base.my_dir + "Document.docx")

# Get the first Run node and cast it to Run object.
run = doc.get_child(aw.NodeType.RUN, 0, True).as_run()

# Make changes to the run 
run.font.color = drawing.Color.red

# Save the result
doc.save(docs_base.artifacts_dir + "WorkingWithNode.change_run_color.docx")

Việc truyền cũng có thể được yêu cầu khi sử dụng phương pháp clone:

doc = aw.Document(docs_base.my_dir + "Document.docx")

clone = doc.clone().as_document()
clone.save(docs_base.artifacts_dir + "CloneAndCombineDocuments.cloning_document.docx")

Như bạn có thể nhận thấy trong mã C# bạn sẽ sử dụng (Paragraph)node để truyền, trong Python bạn phải sử dụng phương thức node.as_paragraph(). Trong phiên bản Python của lớp Aspose.Words Node giới thiệu liên kết các phương thức as_xxx sau:

• as_document()
• as_section()
• as_body()
• as_header_footer()
• as_table()
• as_row()
• as_cell()
• as_paragraph()
• as_bookmark_start()
• as_bookmark_end()
• as_editable_range_start()
• as_editable_range_end()
• as_group_shape()
• as_shape()
• as_comment()
• as_footnote()
• as_run()
• as_field_start()
• as_field_separator()
• as_field_end()
• as_form_field()
• as_special_char()
• as_smart_tag()
• as_structured_document_tag()
• as_structured_document_tag_range_start()
• as_structured_document_tag_range_end()
• as_glossary_document()
• as_building_block()
• as_comment_range_start()
• as_comment_range_end()
• as_office_math()
• as_sub_document()
• as_composite_node()

Phương thức as_xxx đưa ra một RuntimeError với thông báo như sau nếu nút không thể xếp vào loại đã chỉ định:

RuntimeError: Proxy error(InvalidCastException): Unable to cast object of type ‘Aspose.Words.XXX’ to type ‘Aspose.Words.Drawing.YYY’.

Trường đúc

Tình huống tương tự cũng được áp dụng cho các lĩnh vực. Ví dụ mã sau đây minh họa cách thay thế các liên kết siêu liên kết:

doc = aw.Document(docs_base.my_dir + "Hyperlinks.docx")

for field in doc.range.fields :
            
    if field.type == aw.fields.FieldType.FIELD_HYPERLINK:
                
        hyperlink = field.as_field_hyperlink()
    
        # Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if hyperlink.sub_address != None :
            continue
    
        hyperlink.address = "https:#www.aspose.com"
        hyperlink.result = "Aspose - The .net & Java Component Publisher"

doc.save(docs_base.artifacts_dir + "WorkingWithFields.replace_hyperlinks.docx")

Như bạn có thể nhận thấy, đối tượng Field cũng cung cấp tập hợp các phương thức as_xxx, được liệt kê bên dưới:

• as_field_unknown()
• as_field_merge_barcode()
• as_field_display_barcode()
• as_field_print()
• as_field_private()
• as_field_advance()
• as_field_form_check_box()
• as_field_form_drop_down()
• as_field_index()
• as_field_rd()
• as_field_ta()
• as_field_toa()
• as_field_ask()
• as_field_auto_text()
• as_field_auto_text_list()
• as_field_bibliography()
• as_field_citation()
• as_field_dde()
• as_field_dde_auto()
• as_field_fill_in()
• as_field_glossary()
• as_field_import()
• as_field_include()
• as_field_shape()
• as_field_database()
• as_field_skip_if()
• as_field_list_num()
• as_field_rev_num()
• as_field_section()
• as_field_section_pages()
• as_field_data()
• as_field_embed()
• as_field_ocx()
• as_field_auto_num()
• as_field_auto_num_lgl()
• as_field_auto_num_out()
• as_field_add_in()
• as_field_barcode()
• as_field_bidi_outline()
• as_field_eq()
• as_field_footnote_ref()
• as_field_info()
• as_field_user_address()
• as_field_user_initials()
• as_field_user_name()
• as_field_include_picture()
• as_field_page()
• as_field_create_date()
• as_field_edit_time()
• as_field_print_date()
• as_field_save_date()
• as_field_go_to_button()
• as_field_author()
• as_field_comments()
• as_field_file_name()
• as_field_file_size()
• as_field_keywords()
• as_field_last_saved_by()
• as_field_num_chars()
• as_field_num_pages()
• as_field_num_words()
• as_field_subject()
• as_field_template()
• as_field_title()
• as_field_formula()
• as_field_symbol()
• as_field_quote()
• as_field_set()
• as_field_address_block()
• as_field_compare()
• as_field_date()
• as_field_doc_property()
• as_field_doc_variable()
• as_field_greeting_line()
• as_field_hyperlink()
• as_field_if()
• as_field_include_text()
• as_field_link()
• as_field_macro_button()
• as_field_merge_field()
• as_field_merge_rec()
• as_field_merge_seq()
• as_field_next()
• as_field_next_if()
• as_field_note_ref()
• as_field_page_ref()
• as_field_ref()
• as_field_seq()
• as_field_style_ref()
• as_field_tc()
• as_field_time()
• as_field_toc()
• as_field_xe()
• as_field_form_text()

Kiểu đúc

Việc truyền cũng được yêu cầu để làm việc với các kiểu bảng:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

table = builder.start_table()
builder.insert_cell()
builder.write("Name")
builder.insert_cell()
builder.write("Value")
builder.end_row()
builder.insert_cell()
builder.insert_cell()
builder.end_table()

# Add a table style and modify it's properties.
tableStyle = doc.styles.add(aw.StyleType.TABLE, "MyTableStyle1").as_table_style()
tableStyle.borders.line_style = aw.LineStyle.DOUBLE
tableStyle.borders.line_width = 1
tableStyle.left_padding = 18
tableStyle.right_padding = 18
tableStyle.top_padding = 12
tableStyle.bottom_padding = 12

table.style = tableStyle

doc.save(docs_base.artifacts_dir + "WorkingWithTableStylesAndFormatting.create_table_style.docx")

Điều khiển Ole đúc

Ví dụ mã sau đây minh họa cách đọc thuộc tính điều khiển ActiveX:

doc = aw.Document(docs_base.my_dir + "ActiveX controls.docx")

properties = ""
for shape in doc.get_child_nodes(aw.NodeType.SHAPE, True) :
            
    shape = shape.as_shape()
            
    if shape.ole_format == None :
        break
    
    oleControl = shape.ole_format.ole_control
    if oleControl.is_forms2_ole_control :
                
        checkBox =  oleControl.as_forms2_ole_control()
        properties = properties + "\nCaption: " + checkBox.caption
        properties = properties + "\nValue: " + checkBox.value
        properties = properties + "\nEnabled: " + str(checkBox.enabled)
        properties = properties + "\nType: " + str(checkBox.type)
    
        if checkBox.child_nodes != None :
            properties = properties + "\nChildNodes: " + checkBox.child_nodes
    
        properties += "\n"

properties = properties + "\nTotal ActiveX Controls found: " + str(doc.get_child_nodes(aw.NodeType.SHAPE, True).count)
print("\n" + properties)

Truyền nguồn phông chữ

Lớp FontSourceBase cung cấp tập hợp các phương thức as_xxx, được liệt kê bên dưới:

• as_file_font_source()
• as_folder_font_source()
• as_memory_font_source()
• as_stream_font_source()
• as_system_font_source()

Truy cập thuộc tính của bộ chỉ mục

Aspose.Words cho Python chỉ cho phép các thuộc tính của trình lập chỉ mục theo loại int, trong .NET tuy nhiên có thể sử dụng các loại khác, ví dụ như chuỗi. Để lấp đầy khoảng trống này, các lớp sau có một phương thức bổ sung:

• FormFieldCollection * get_by_name(bookmark_name)
• FontInfoCollection * get_by_name(name)
• CustomXmlPartCollection * get_by_id(id)
• CustomXmlPropertyCollection * get_by_name(name)
• BuiltInDocumentProperties * get_by_name(name)
• CustomDocumentProperties * get_by_name(name)
• BookmarksOutlineLevelCollection * get_by_name(name)
• VbaModuleCollection * get_by_name(name)
• BookmarkCollection * get_by_name(bookmark_name)
• BorderCollection * get_by_border_type(border_type)
• HeaderFooterCollection * get_by_header_footer_type(header_footer_type)
• StyleCollection * get_by_name(name) * get_by_style_identifier(sti)
• VariableCollection * get_by_name(name)

Đặt tên thành viên API

Để gần gũi hơn với thế giới Python, các thành viên API của Aspose.Words dành cho Python via .NET sử dụng kiểu rắn Pythonic, tuy nhiên trong hầu hết các trường hợp, chúng có kiểu tương tự 1-1 trong Aspose.Words cho .NET API. Bạn có thể tìm thấy những chất tương tự này trong tập tin xml.