ทำงานกับบรรณานุกรม

ทำงานกับบรรณานุกรม

ฟีเจอร์การอ้างอิงและบรรณานุกรมของ Word จะจัดเก็บข้อมูลต้นฉบับแยกจากฟิลด์ที่แสดงผล. Aspose.Words FOSS สำหรับ .NET โมเดลที่ดึงข้อมูลผ่าน Aspose.Words.Bibliography เนมสเปซ – Source, Contributor, Person, และ Corporate – เข้าถึงจาก Document.Bibliography. หน้านี้ครอบคลุมการสร้างและการอ่านข้อมูลนั้น; ส่วน CITATION and BIBLIOGRAPHY ฟิลด์ที่แสดงผลนั้นถูกครอบคลุมใน คู่มือการเชื่อมโยงและอ้างอิง.

โมเดลข้อมูลบรรณานุกรม

Document.Bibliography เป็นอินสแตนซ์ของ Bibliography ที่มี BibliographyStyle – ชื่อสไตล์การอ้างอิง (เช่น APA หรือ MLA) ที่ควรนำไปใช้เมื่อฟิลด์ BIBLIOGRAPHY ถูกอัปเดต – และ Sources, ซึ่งเป็น IList<Source> ที่เก็บบันทึกแหล่งที่มาทั้งหมดที่มีในเอกสาร.

บันทึกแหล่งที่มา

Source ถูกสร้างขึ้นด้วย Source(tag, sourceType), โดยที่ Tag คือรหัสสั้นที่ FieldCitation.SourceTag และ FieldBibliography.SourceTag ใช้เพื่อจับคู่, และ SourceType เป็น enum ที่ระบุประเภทของแหล่งที่มา – ค่าที่มีรวมถึง Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, และ Misc. Source.Type แยกเก็บประเภทของแหล่งที่มาเป็นสตริงธรรมดา. นอกเหนือจาก Title และ ShortTitle, Source เปิดเผยหลายสิบฟิลด์เฉพาะหมวดหมู่ตามที่ต้องการสำหรับ SourceType ที่เลือก – ฟิลด์หนังสือ (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), ฟิลด์วารสาร (JournalName, PeriodicalTitle, PublicationTitle, Issue), ฟิลด์เว็บ (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), ฟิลด์กฎหมาย (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), ฟิลด์การบันทึกและการแพร่ภาพ (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, ฟิลด์วิทยานิพนธ์ (ThesisType, Institution, Department), และฟิลด์ทั่วไป (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors คือ ContributorCollection ที่มีคุณสมบัติเพียงหนึ่งต่อบทบาทผู้ร่วมเขียน – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, และ BookAuthor – แต่ละอันเป็นประเภท Contributor, ฐานทั่วไปสำหรับสองประเภทของผู้ร่วมเขียนที่อธิบายด้านล่าง.

ผู้ร่วมเขียนบุคคลธรรมดา vs. ผู้ร่วมเขียนองค์กร

Contributor ถูกนำไปใช้โดยสอง class: Person (First, Middle, Last) สำหรับบุคคลเดียว, และ Corporate (Name) สำหรับองค์กร. PersonCollection ยัง derives จาก Contributor และ implements IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), ดังนั้นบทบาทผู้ร่วมเขียนที่มีผู้เขียนหลายคนสามารถกำหนด PersonCollection ได้เช่นเดียวกับบทบาทที่มีผู้เขียนคนเดียวที่กำหนด Person – ทั้งสองพร้อมกับ Corporate ตรงตามคุณสมบัติบทบาทประเภท Contributor เดียวกัน.

การแสดงผลเนื้อหาบรรณานุกรม

Source บันทึกเพียงให้ข้อมูล – พวกมันไม่ได้สร้างข้อความอ้างอิงหรือบรรณานุกรมด้วยตนเอง สิ่งนั้นเกิดขึ้นผ่าน FieldCitation and FieldBibliography, ซึ่งค้นหา Source โดยการจับคู่ SourceTag against Source.Tag. ดู คู่มือการเชื่อมโยงและอ้างอิง สำหรับคลาสฟิลด์เหล่านั้น.

เคล็ดลับและแนวปฏิบัติที่ดีที่สุด

• ให้ทุก Source มี Tag ที่ไม่ซ้ำกัน – นั่นเป็นค่าที่เดียวที่ FieldCitation.SourceTag และ FieldBibliography.SourceTag ใช้เพื่อค้นหารายการที่ถูกต้อง.
• เติมข้อมูลเฉพาะฟิลด์ Source ที่เกี่ยวข้องกับ SourceType ของมัน – ตัวอย่างเช่น แหล่งข้อมูล Book ไม่ได้ใช้ Broadcaster หรือ CaseNumber, แต่ class ไม่บังคับให้ทำเช่นนั้น.
• ใช้ Person สำหรับผู้ร่วมเขียนที่ระบุชื่อเดียว, PersonCollection สำหรับบุคคลหลายคนในบทบาทเดียวกัน, และ Corporate เมื่อผู้ร่วมเขียนเป็นองค์กรแทนบุคคล – กำหนดค่าที่ตรงกับคุณสมบัติบทบาท ContributorCollection ที่เหมาะสม.
• Bibliography.BibliographyStyle บันทึกชื่อสไตล์การอ้างอิงที่ต้องใช้; รักษาความสอดคล้องกับรูปแบบการแสดงผลที่ฟิลด์ FieldCitation ของคุณคาดหวัง.
• เพิ่มทุก Source ไปยัง Document.Bibliography.Sources ก่อนอัปเดตฟิลด์ CITATION หรือ BIBLIOGRAPHY ที่อ้างอิงถึงมัน – แหล่งที่หายไปหมายความว่าฟิลด์ที่อ้างอิงไม่มีข้อมูลให้แก้ไข.

ปัญหาที่พบบ่อย

FAQ

ฉันจะเพิ่มแหล่งข้อมูลหนังสือที่มีผู้เขียนคนเดียวอย่างไร?

สร้าง Source ด้วย SourceType.Book, ตั้งค่า BookTitle, Publisher, Year และฟิลด์ที่เกี่ยวข้อง, จากนั้นกำหนด Person ให้กับ Source.Contributors.Author.

ฉันจะเพิ่มแหล่งข้อมูลที่มีผู้เขียนหลายคนอย่างไร?

กำหนด PersonCollection (ที่ถูกเติมด้วยอินสแตนซ์ Person ผ่าน Add()) ให้กับคุณสมบัติบทบาท ContributorCollection ที่เกี่ยวข้อง เช่น Author.

ฉันจะอ้างอิงองค์กรแทนบุคคลได้อย่างไร?

กำหนดอินสแตนซ์ของ Corporate (ที่สร้างด้วย Name ขององค์กร) ให้กับคุณสมบัติบทบาท ContributorCollection แทนที่จะเป็น Person หรือ PersonCollection.

บันทึก Source ปรากฏในเอกสารที่เรนเดอร์จริง ๆ ที่ไหน?

พวกมันไม่ได้แสดงผลด้วยตัวเอง – FieldCitation and FieldBibliography ฟิลด์เรนเดอร์เนื้อหาที่สร้างจากฟิลด์เหล่านั้น, โดยจับคู่ด้วย SourceTag. ดู คู่มือการเชื่อมโยงและอ้างอิง.

API Reference สรุป

ดูเพิ่มเติม

• Aspose.Words for .NET — Enterprise Documentation