 | Source |
Applicable for: 5.5.5
Extends the base SourceCitationStructure class with properties specific to the applicable GEDCOM standards.
Inheritance HierarchySystemObject
Patagames.GedcomNetSdk.PrimitivesContext
Patagames.GedcomNetSdk.StructuresGedcomStructure
Patagames.GedcomNetSdk.StructuresSourceCitationStructure
Patagames.GedcomNetSdk.Structures.Ver555SourceCitation
Patagames.GedcomNetSdk.PrimitivesContext
Patagames.GedcomNetSdk.StructuresGedcomStructure
Patagames.GedcomNetSdk.StructuresSourceCitationStructure
Patagames.GedcomNetSdk.Structures.Ver555SourceCitation
Namespace: Patagames.GedcomNetSdk.Structures.Ver555
Assembly: Patagames.Gedcom.Net.Sdk (in Patagames.Gedcom.Net.Sdk.dll) Version: 1.0.8
SyntaxThe SourceCitation type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SourceCitation | Initializes a new instance of the SourceCitation class |
Properties| Name | Description | |
|---|---|---|
 | CustomTags |
Gets the collection of сгыещь tags encountered in this context.
(Inherited from Context) |
| Date | Gets or sets the date that this event data was entered into the original source document. |
| EventTypeCitedFrom | Gets or sets a code that indicates the type of event which was responsible for the source entry being recorded. For example, if the entry was created to record a birth of a child, then the type would be BIRT regardless of the assertions made from that record, such as the mother's name or mother's birth date. This will allow a prioritized best view choice and a determination of the certainty associated with the source used in asserting the cited fact. |
| Links |
Gets or sets a collection of the links to citation.
(Inherited from SourceCitationStructure) |
| Notes |
Gets or sets the collection of notes.
(Inherited from SourceCitationStructure) |
| Page | Gets or sets the specific location with in the information referenced. |
| Quay |
Gets or sets the QUAY tag's value conveys the submitter's quantitative evaluation of the credibility of a piece of
information, based upon its supporting evidence.Some systems use this feature to rank multiple
conflicting opinions for display of most likely information first. It is not intended to eliminate the
receiver's need to evaluate the evidence for themselves.
(Inherited from SourceCitationStructure) |
| Role | Indicates what role this person played in the event that is being cited in this context. |
| SourceId | Gets or sets the SourceId of a source record. |
| Text | Gets or sets a verbatim copy of any description contained within the source. This indicates notes or text that are actually contained in the source document, not the submitter's opinion about the source. This should be, from the evidence point of view, "what the original record keeper said" as opposed to the researcher's interpretation. |
| UnknownTags |
Gets the collection of unknown tags encountered in this context.
(Inherited from Context) |
Methods| Name | Description | |
|---|---|---|
 | ContextClosed |
Called when the context is closed. The default implementation does nothing.
(Inherited from Context) |
| ContextOpened |
Called when a context is opened. The default implementation does nothing.
(Inherited from Context) |
| Deserialize |
Read data from the parser and deserialize it into the Gedcom.Net SDK class library.
(Inherited from Context) |
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object) |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object) |
| GetHashCode | Serves as the default hash function. (Inherited from Object) |
| GetType | Gets the Type of the current instance. (Inherited from Object) |
| GetValueT |
Hets the value and main tags of the specified propName.
(Inherited from Context) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object) |
| PreporcessTag |
Called before tag processing begins. The default implementation does nothing.
(Inherited from Context) |
| ProcessCustomTag |
Add the custom tag into the CustomTags collection.
(Inherited from Context) |
| ProcessUnknownTag |
When overridden, tries to process a tag that cannot be processed by the GEDCOM mechanism, because the tag is unknown or encountered in an unexpected context.
(Inherited from Context) |
| Serialize |
Seserialize the Gedcom.Net SDK class library and write data to the composer.
(Inherited from Context) |
| ToString | Returns a string that represents the current object. (Inherited from Object) |
Remarks
The data provided in the SourceCitation structure is source-related information specific to the data being cited.
The information intended to be placed in the citation structure includes:
- The pointer to the SourceRecord, which contains a more general description of the source used for the fact being cited.
- Information, such as a page number, to help the user find the cited data within the referenced source. This is stored in the Page.
- Actual text from the source that was used in making assertions, for example a date phrase as actually recorded in the source, or significant notes written by the recorder, or an applicable sentence from a letter. This is stored in the Text.
- Data that allows an assessment of the relative value of one source over another for making the recorded assertions (primary or secondary source, etc.). Data needed for this assessment is data that would help determine how much time from the date of the asserted fact and when the source was actually recorded, what type of event was cited, and what type of role did this person have in the cited source.
GEDCOM 5.4 (1995) introduced source citations using a reference to a (top-level) SourceRecord record and made it the preferred source citation format, to reduce redundancy. GEDCOM 5.5 and 5.5.1. continued to allow old format source citations that do not use SourceRecord record for backward compatibility with old systems, but clearly stated that the new format is preferred.
GEDCOM 5.5.5 no longer supports the old format, which has been deprecated since 1995. In GEDCOM 5.5.5, each source citation must reference a (top-level) SourceRecord record. Existing applications that still support the unstructured source citation format should actively encourage users to upgrade all such citations (or at least the ones that cannot be mapped automatically), so that the user can take advantage of its GEDCOM 5.5.5 support.
See Also