ความแตกต่างของเวอร์ชัน Python และ .NET

Aspose.Words สำหรับ Python via .NET เป็น wrapper ของ Aspose.Words สำหรับ .NET นั่นคือสาเหตุที่ผลิตภัณฑ์ทั้งสองมีชุดคุณลักษณะที่เกือบจะเหมือนกัน อย่างไรก็ตาม มีความแตกต่างบางประการในการทำงานและความแตกต่างในฟีเจอร์และ API ซึ่งอธิบายไว้ในหน้านี้

ความแตกต่างของคุณสมบัติ

เนื่องจากกระบวนการห่อ จึงทำให้มีฟีเจอร์บางอย่างที่ไม่มีในเวอร์ชัน Python ต่อไปนี้เป็นรายการคุณลักษณะที่โดดเด่นที่สุดซึ่งปัจจุบันไม่มีในเวอร์ชัน Python

• ยังไม่รองรับการใช้งานอินเทอร์เฟซ นั่นคือสาเหตุที่ไม่สามารถใช้การเรียกกลับเช่น IWarningCallback, IReplacingCallback, IFieldUpdatingCallback, IFieldMergingCallback เป็นต้น
• คุณสมบัติการพิมพ์ไม่พร้อมใช้งานเนื่องจาก Aspose.Words เวอร์ชัน .NET Standard 2.0 ถูกใช้เป็นแบ็คเอนด์ของเวอร์ชัน Python ซึ่งไม่มีฟังก์ชันนี้เช่นกัน
• มีเพียงฟังก์ชัน Mail Merge แบบธรรมดาเท่านั้นที่มีอาร์เรย์ของชื่อฟิลด์และค่าของฟิลด์เป็นแหล่งข้อมูล
• ขณะนี้การใช้งาน DocumentVisitor ไม่สามารถทำได้จากโค้ด Python

การส่งวัตถุ Aspose.Words ใน Python

แม้ว่าการคัดแยกประเภทจะไม่ใช่เรื่องปกติสำหรับนักพัฒนา Python แต่งานบางอย่างก็ไม่สามารถทำได้สำเร็จหากไม่มีการหล่อโหนดหรือช่องเอกสารให้เป็นประเภทคอนกรีต Aspose.Words สำหรับ Python via .NET มีวิธีการพิเศษที่ช่วยให้สามารถร่ายวัตถุได้เมื่อจำเป็น

โหนดหล่อ

คลาสพื้นฐานสำหรับโหนดเอกสารทั้งหมดใน Aspose.Words DOM คือคลาส Node ตัวอย่างเช่น ส่งคืนเมธอด get_child และอินสแตนซ์ของคลาส Node แต่หากคุณต้องการแก้ไขโหนดที่ส่งคืน ในกรณีส่วนใหญ่ คุณควรส่งโหนดนั้นเป็นประเภทคอนกรีต รหัสต่อไปนี้สาธิตวิธีการเปลี่ยนสีแบบอักษรของ Run แรกในเอกสาร:

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")

อาจจำเป็นต้องมีการแคสต์เมื่อใช้วิธีการ 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")

ดังที่คุณอาจสังเกตเห็นว่าส่วนใดในโค้ด C# คุณจะใช้ (Paragraph)node ในการแคสต์ ใน Python คุณต้องใช้วิธีการ node.as_paragraph() ในเวอร์ชัน Python ของคลาส Aspose.Words Node จะแนะนำลิงก์ของวิธี as_xxx ต่อไปนี้:

• 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()

เมธอด as_xxx จะสร้าง RuntimeError ด้วยข้อความดังต่อไปนี้ หากโหนดไม่สามารถจัดเป็นประเภทที่ระบุได้:

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

สนามหล่อ

สถานการณ์เดียวกันนี้ใช้กับฟิลด์ ตัวอย่างโค้ดต่อไปนี้สาธิตวิธีการแทนที่ลิงก์ไฮเปอร์ลิงก์:

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")

ดังที่คุณอาจสังเกตเห็นว่าออบเจ็กต์ Field ยังมีชุดวิธี as_xxx อีกด้วย ซึ่งมีรายชื่ออยู่ด้านล่าง:

• 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()

สไตล์การหล่อ

จำเป็นต้องมีการแคสต์เพื่อทำงานกับสไตล์ตาราง:

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")

กำลังหล่อการควบคุม Ole

ตัวอย่างรหัสต่อไปนี้สาธิตวิธีการอ่านคุณสมบัติการควบคุม 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)

กำลังส่งแหล่งที่มาของแบบอักษร

คลาส FontSourceBase มีชุดวิธี as_xxx ซึ่งมีรายชื่ออยู่ด้านล่าง:

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

การเข้าถึงคุณสมบัติตัวสร้างดัชนี

Aspose.Words สำหรับ Python อนุญาตให้ใช้คุณสมบัติตัวสร้างดัชนีตามประเภท int เท่านั้น ใน .NET อย่างไรก็ตาม คุณสามารถใช้ประเภทอื่นได้ เช่น สตริง เพื่อเติมเต็มช่องว่างนี้ คลาสต่อไปนี้มีวิธีการเพิ่มเติม:

• 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)

การตั้งชื่อสมาชิก API

เพื่อให้ใกล้ชิดกับโลก Python มากขึ้น สมาชิก API ของ Aspose.Words สำหรับ Python via .NET จะใช้รูปแบบงูหลาม อย่างไรก็ตาม ในกรณีส่วนใหญ่ สมาชิก API ของ Aspose.Words สำหรับ .NET API จะมีแบบอะนาล็อกหนึ่งต่อหนึ่ง คุณสามารถค้นหาแอนะล็อกเหล่านี้ได้ใน ไฟล์ xml