Trabalhando com Bibliografia

Trabalhando com Bibliografia

O recurso de citação e bibliografia do Word armazena seus dados de origem separadamente dos campos que os exibem. Aspose.Words FOSS para .NET modelos que obtêm dados através do Aspose.Words.Bibliography namespace – Source, Contributor, Person, e Corporate – acessível a partir de Document.Bibliography. Esta página cobre a construção e a leitura desses dados; o CITATION and BIBLIOGRAPHY campos que os exibem são abordados no guia de links e referências.

O Modelo de Dados da Bibliografia

Document.Bibliography é uma instância Bibliography com BibliographyStyle – o nome do estilo de citação (por exemplo APA ou MLA) que deve ser aplicado quando um campo BIBLIOGRAPHY é atualizado – e Sources, um IList<Source> que contém todos os registros de fonte disponíveis no documento.

Registros de Fonte

Source é construído com Source(tag, sourceType), onde Tag é o identificador curto que FieldCitation.SourceTag e FieldBibliography.SourceTag comparam, e SourceType é um enum que identifica o tipo de fonte — valores incluem Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic e Misc. Source.Type armazena separadamente o tipo de fonte como uma string simples. Além de Title e ShortTitle, Source expõe dezenas de campos específicos de categoria conforme necessário para o SourceType escolhido — campos de livro (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), campos de periódico (JournalName, PeriodicalTitle, PublicationTitle, Issue), campos da web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), campos jurídicos (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), campos de gravação e transmissão (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, campos de tese (ThesisType, Institution, Department), e campos gerais (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors é um ContributorCollection com uma propriedade por função de colaborador – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist e BookAuthor – cada uma tipada como Contributor, a base comum para os dois tipos de colaborador descritos abaixo.

Contribuintes Individuais vs. Corporativos

Contributor é implementado por duas classes: Person (First, Middle, Last) para um único indivíduo, e Corporate (Name) para uma organização. PersonCollection também herda de Contributor e implementa IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), de modo que uma função de colaborador que tem múltiplos autores individuais pode receber um PersonCollection tão facilmente quanto uma função com um único autor recebe um Person – ambos, junto com Corporate, satisfazem a mesma propriedade de função tipada Contributor.

Renderizando o Conteúdo da Bibliografia

Source os registros apenas fornecem dados – eles não renderizam texto de citação ou bibliografia por si mesmos. Isso acontece através FieldCitation and FieldBibliography, que procuram um Source por correspondência SourceTag against Source.Tag. Veja o guia de links e referências para essas classes de campo.

Dicas e Melhores Práticas

• Atribua a cada Source um Tag único – é o único valor que FieldCitation.SourceTag e FieldBibliography.SourceTag usam para encontrar o registro correto.
• Preencha apenas os campos Source relevantes ao seu SourceType – uma fonte Book, por exemplo, não tem uso para Broadcaster ou CaseNumber, mas a classe não impõe isso para você.
• Use Person para um único contribuinte nomeado, PersonCollection para várias pessoas no mesmo cargo e Corporate quando o contribuinte for uma organização em vez de uma pessoa — atribua o que for adequado à propriedade de cargo ContributorCollection correspondente.
• Bibliography.BibliographyStyle registra qual nome de estilo de citação aplicar; mantenha-o consistente com a forma como os campos FieldCitation esperam que sua saída seja formatada.
• Adicione cada Source a Document.Bibliography.Sources antes de atualizar os campos CITATION ou BIBLIOGRAPHY que o referenciam — uma fonte ausente significa que o campo de referência não tem nada para resolver.

Problemas Comuns

FAQ

Como adiciono uma fonte de livro com um único autor?

Crie um Source com SourceType.Book, defina BookTitle, Publisher, Year e campos relacionados, então atribua um Person a Source.Contributors.Author.

Como adiciono uma fonte com vários autores?

Atribua um PersonCollection (povoado com instâncias de Person via Add()) à propriedade de função ContributorCollection relevante, como Author.

Como cito uma organização em vez de um indivíduo?

Atribua uma instância de Corporate (construída com o Name da organização) à propriedade de função ContributorCollection em vez de um Person ou PersonCollection.

Onde os registros Source realmente aparecem no documento renderizado?

Eles não são renderizados por conta própria – FieldCitation and FieldBibliography campos renderizam conteúdo construído a partir deles, correspondido por SourceTag. Veja o guia de links e referências.

API Reference Resumo

Ver também

• Aspose.Words for .NET — Enterprise Documentation