# Bibliographic References

Bibliographic references represent links (in the form of text) to documents, books, films and everything that can be cited in a Word document. You can manage those in **RadRichTextEditor** by going to References -> Citations & Bibliography. It looks like this:

![WinForms RadRichTextEditor Bibliographic References](https://www.telerik.com/products/winforms/documentation/assets/f69fb0abbd73e620d94e4e11581a8f83/richtexteditor-features-references-biliographic-references001.png)

This article covers:

* [Add Bibliographic Reference](https://www.telerik.com/products/winforms/documentation/controls/richtexteditor/features/references/bibliographic-references#add-bibliographic-reference)

* [User Interface](https://www.telerik.com/products/winforms/documentation/controls/richtexteditor/features/references/bibliographic-references#user-interface)

* [Using Bibliographic References API](https://www.telerik.com/products/winforms/documentation/controls/richtexteditor/features/references/bibliographic-references#using-bibliographic-references-api)

## Add Bibliographic Reference

The two main parts of Bibliographic References are:

### Source

This is what describes the source you want to refer. We named the class representing a source **BibliographicSource**. It has a number of properties:

* **Type of Source** – there is a predefined list of available types (Book, Book Section, Journal Article, Conference Proceeding, etc.). You have to choose the type of your source (for example if you quote a line from a movie you can choose type "Film", etc).

* **TagName** – this is the unique identifier of the Source. Every source has to have a unique TagName. You will be prompted if you try to enter a duplicate.

* **All other fields** – there are a number of Fields that an object of type **BibliographicSource** possesses like Author, Title, Year, City, etc. Those properties are a lot and we won’t enumerate them all now, but you have to know that every type of source includes some subset of those properties. When you open the **AddNewBibliographicSourceDialog**, upon changing the type only the necessary properties will be shown. The dialog looks like this:

  ![WinForms RadRichTextEditor Source](https://www.telerik.com/products/winforms/documentation/assets/29a93478947236f6c6c0556e4898b0a7/richtexteditor-features-references-biliographic-references002.png)

### Style

This is how the source is represented when inserted in the document. There are a number of predefined styles in Word. We support 3 for now – APA Fifth Edition, Harvard – Anglia 2008 and ISO 690 – First Element and Date. The name of the class we use to describe a style is called **BibliographicReferenceStyleBase**. Every style should derive from this abstract class and implement the methods needed to function properly. Those methods are:

* Properties **Key** and **Name** – the key is used to uniquely identify the style in the document and the Name is what is displayed in the drop down.

* **Get{Type}Citation()**  method -  there is such method for every **SourceType**. It returns string and describes how the citation looks like according to this Style.

* **Get{Type}BibliographyRecord()** – there is such method for every **SourceType**. It returns object of type **Telerik.Windows.Documents.Model.Paragraph** and describes how the entry should look like in the Bibliography.

## User Interface

You already saw how the **AddNewBibliographicSourceDialog** looks like. It is used to insert a new Source. After you have inserted all the sources you need, you can manage them through the **ManageBibliographicSourcesDialog**. It looks like so:

![WinForms RadRichTextEditor User Interface](https://www.telerik.com/products/winforms/documentation/assets/8cd0dc75acb50c4865e21a83df8647ec/richtexteditor-features-references-biliographic-references003.png)

As you can see you can edit an existing source, delete an existing source or create a new one.

You can insert a bibliography on the caret position using the following button:

![WinForms RadRichTextEditor Insert CaretPosition](https://www.telerik.com/products/winforms/documentation/assets/5f85b2f69ee9d6b76da38134ce821594/richtexteditor-features-references-biliographic-references004.png)

When you click on the "*Insert Citation*" drop down button you will get a list with all the available sources. Clicking on one will insert a Citation in the document. At the bottom there is another button that allows you to create new **BibliographicSource** object (it shows the **AddNewBibliographicSource** dialog):

![WinForms RadRichTextEditor Add New Source On Caret Position](https://www.telerik.com/products/winforms/documentation/assets/8ebef0a38f7c28eb2073fa05223bccda/richtexteditor-features-references-biliographic-references005.png)

## Using Bibliographic References API

Everything that we can do using UI, we can do in code behind too. All sources reside in **RadDocument.BibliographicSources** collection. It is of type **ObservableCollection\<BibliographicSource>**. What you have to do in order to insert a source is to create an object of the proper type and add it to the collection. The UI will be updated accordingly. This is *true* for updating and removing sources as well.

This is how you can add a new source:

```C#
BibliographicSource bibliographicSource = new BibliographicSource("test");
bibliographicSource.Author = "authorTest";
bibliographicSource.Title = "titleTest";
bibliographicSource.Editor = "editorTest";
bibliographicSource.SourceType = BibliographicSourceType.Book;
this.radRichTextEditor1.Document.BibliographicSources.Add(bibliographicSource);
```

```VB.NET
Dim bibliographicSource As New BibliographicSource("test")
bibliographicSource.Author = "authorTest"
bibliographicSource.Title = "titleTest"
bibliographicSource.Editor = "editorTest"
bibliographicSource.SourceType = BibliographicSourceType.Book
Me.radRichTextEditor1.Document.BibliographicSources.Add(bibliographicSource)
```

To create a custom **BibliographicStyle** you have to derive from **BibliographicReferenceStyleBase** and add the style to the document so it can be usable. All styles are kept in a dictionary that matches a string to a  **BibliographicReferenceStyleBase** object. Usually the string is the key of the particular style. Adding style is as easy as:

```C#
APAFifthEditionStyle APAFifthEdition = new APAFifthEditionStyle();
this.radRichTextEditor1.Document.BibliographicStyles.Add(APAFifthEdition.Key, APAFifthEdition);

HarvardAnglia2008Style HarvardAnglia2008 = new HarvardAnglia2008Style();
this.radRichTextEditor1.Document.BibliographicStyles.Add(HarvardAnglia2008.Key, HarvardAnglia2008);

ISO690_FirstElementAndDateStyle ISO690_FirstElementAndDate =
new ISO690_FirstElementAndDateStyle();
this.radRichTextEditor1.Document.BibliographicStyles.Add(ISO690_FirstElementAndDate.Key,
ISO690_FirstElementAndDate);
```

```VB.NET
Dim APAFifthEdition As New APAFifthEditionStyle()
Me.radRichTextEditor1.Document.BibliographicStyles.Add(APAFifthEdition.Key, APAFifthEdition)

Dim HarvardAnglia2008 As New HarvardAnglia2008Style()
Me.radRichTextEditor1.Document.BibliographicStyles.Add(HarvardAnglia2008.Key, HarvardAnglia2008)

Dim ISO690_FirstElementAndDate As New ISO690_FirstElementAndDateStyle()
Me.radRichTextEditor1.Document.BibliographicStyles.Add(ISO690_FirstElementAndDate.Key, ISO690_FirstElementAndDate)
```

### Insert Citation Field using code behind

The Citation field is a field not different from every other field. You can use the **InsertFIeld()** method of  **RadDocument** to insert a citation:

```C#
CitationField citationField = new CitationField();
citationField.SourceName = "test";
this.radRichTextEditor1.InsertField(citationField, FieldDisplayMode.Result);
```

```VB.NET
Dim citationField As New CitationField()
citationField.SourceName = "test"
Me.radRichTextEditor1.InsertField(citationField, FieldDisplayMode.Result)
```

### Insert Bibliography Field using code behind

The Bibliography field is a field not different from every other field. You can use the **InsertFIeld()** method of
**RadDocument** to insert a citation:

```C#
BibliographyField bibliographyField = new BibliographyField();
this.radRichTextEditor1.InsertField(bibliographyField, FieldDisplayMode.Result);
```

```VB.NET
Dim bibliographyField As New BibliographyField()
Me.radRichTextEditor1.InsertField(bibliographyField, FieldDisplayMode.Result)
```

### Changing Bibliographic Style using code behind

There is a method called **ChangeBibliographicStyle()** on **RadRichTextEditor**. It accepts one argument of type **BibliographicReferenceStyleBase**. Changing the current style is as simple as:

```C#
this.radRichTextEditor1.ChangeBibliographicStyle(new HarvardAnglia2008Style());
```

```VB.NET
Me.radRichTextEditor1.ChangeBibliographicStyle(New HarvardAnglia2008Style())
```