Làm việc với Thư mục tham khảo

Luyện tập với Thư mục

Tính năng trích dẫn và thư mục của Word lưu trữ dữ liệu nguồn riêng biệt so với các trường hiển thị nó. Aspose.Words FOSS cho .NET các mô hình lấy dữ liệu qua Aspose.Words.Bibliography không gian tên – Source, Contributor, Person, và Corporate – có thể truy cập từ Document.Bibliography. Trang này đề cập đến việc xây dựng và đọc dữ liệu đó; các CITATION and BIBLIOGRAPHY các trường hiển thị nó được đề cập trong hướng dẫn liên kết và tham khảo.

Mô hình Dữ liệu Thư mục

Document.Bibliography là một thể hiện Bibliography với BibliographyStyle – tên kiểu trích dẫn (ví dụ APA hoặc MLA) nên được áp dụng khi trường BIBLIOGRAPHY được cập nhật – và Sources, một IList<Source> chứa mọi bản ghi nguồn có sẵn cho tài liệu.

Bản ghi Nguồn

Source được xây dựng với Source(tag, sourceType), trong đó Tag là định danh ngắn mà FieldCitation.SourceTag và FieldBibliography.SourceTag khớp với, và SourceType là một enum xác định loại nguồn – các giá trị bao gồm Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, và Misc. Source.Type riêng biệt lưu trữ loại nguồn dưới dạng chuỗi đơn giản. Ngoài Title và ShortTitle, Source mở ra hàng chục trường đặc thù cho mỗi danh mục tùy theo SourceType đã chọn – các trường sách (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), các trường tạp chí (JournalName, PeriodicalTitle, PublicationTitle, Issue), các trường web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), các trường pháp luật (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), các trường ghi âm và phát sóng (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, các trường luận án (ThesisType, Institution, Department), và các trường chung (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors là một ContributorCollection với một thuộc tính cho mỗi vai trò đóng góp – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, và BookAuthor – mỗi thuộc tính được gõ là Contributor, cơ sở chung cho hai loại người đóng góp được mô tả bên dưới.

Cá nhân vs. Đóng góp doanh nghiệp

Contributor được triển khai bởi hai lớp: Person (First, Middle, Last) cho một cá nhân đơn lẻ, và Corporate (Name) cho một tổ chức. PersonCollection cũng kế thừa từ Contributor và thực thi IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), vì vậy một vai trò đóng góp có nhiều tác giả cá nhân có thể được gán một PersonCollection cũng dễ dàng như một vai trò có một tác giả được gán một Person – cả hai, cùng với Corporate, đáp ứng cùng một thuộc tính vai trò kiểu Contributor.

Kết xuất nội dung thư mục

Source các bản ghi chỉ cung cấp dữ liệu – chúng không tự tạo ra văn bản trích dẫn hoặc thư mục. Điều đó xảy ra thông qua FieldCitation and FieldBibliography, mà tra cứu một Source bằng cách khớp SourceTag against Source.Tag. Xem hướng dẫn liên kết và tham khảo đối với các lớp trường đó.

Mẹo và Thực hành tốt nhất

• Gán mỗi Source một Tag duy nhất – đó là giá trị duy nhất mà FieldCitation.SourceTag và FieldBibliography.SourceTag sử dụng để tìm bản ghi phù hợp.
• Chỉ điền các trường Source liên quan đến SourceType của nó – ví dụ, một nguồn Book không cần đến Broadcaster hoặc CaseNumber, tuy nhiên lớp không áp đặt điều này cho bạn.
• Sử dụng Person cho một người đóng góp được đặt tên duy nhất, PersonCollection cho nhiều cá nhân trong cùng vai trò, và Corporate khi người đóng góp là một tổ chức thay vì một cá nhân — gán cái phù hợp vào thuộc tính vai trò ContributorCollection.
• Bibliography.BibliographyStyle ghi lại tên kiểu trích dẫn nào cần áp dụng; giữ cho nó nhất quán với cách các trường FieldCitation của bạn mong đợi định dạng đầu ra.
• Thêm mọi Source vào Document.Bibliography.Sources trước khi cập nhật các trường CITATION hoặc BIBLIOGRAPHY tham chiếu tới nó — một nguồn bị thiếu có nghĩa là trường tham chiếu không có gì để giải quyết.

Các vấn đề thường gặp

FAQ

Làm thế nào để thêm nguồn sách với một tác giả duy nhất?

Tạo một Source với SourceType.Book, đặt BookTitle, Publisher, Year, và các trường liên quan, sau đó gán một Person cho Source.Contributors.Author.

Làm thế nào để thêm nguồn với nhiều tác giả?

Gán một PersonCollection (được điền bằng các thể hiện Person qua Add()) vào thuộc tính vai trò ContributorCollection liên quan, chẳng hạn như Author.

Làm sao để tôi trích dẫn một tổ chức thay vì một cá nhân?

Gán một thể hiện Corporate (được tạo bằng Name của tổ chức) vào thuộc tính vai trò ContributorCollection thay vì một Person hoặc PersonCollection.

Bản ghi Source thực sự xuất hiện ở đâu trong tài liệu đã được render?

Chúng không tự render – FieldCitation and FieldBibliography các trường render nội dung được xây dựng từ chúng, được khớp bởi SourceTag. Xem hướng dẫn liên kết và tham chiếu.

API Reference Tóm tắt

Xem thêm

• Aspose.Words for .NET — Enterprise Documentation