/// <summary>
/// Constructor that accepts values for all mandatory fields
/// </summary>
///<param name="type">Code that specifies what type of name this is</param>
///<param name="familyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
///<param name="givenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///
public Name( NameType type, string familyName, string givenName )
: base(CommonDTD.NAME)
{
this.SetType( type );
this.FamilyName = familyName;
this.GivenName = givenName;
}
///<summary>Sets the value of the <c><Name></c> element.</summary>
/// <param name="Type">Code that specifies what type of name this is</param>
/// <param name="FamilyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
/// <param name="GivenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///<remarks>
/// <para>This form of <c>setName</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Name</c></para>
/// <para>Version: 2.5</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetName( NameType Type, string FamilyName, string GivenName )
{
RemoveChild( CommonDTD.PERSONALINFORMATION_NAME);
AddChild( CommonDTD.PERSONALINFORMATION_NAME, new Name( Type, FamilyName, GivenName ) );
}
///<summary>Sets the value of the <c><Name></c> element.</summary>
/// <param name="Type">Code that specifies what type of name this is</param>
/// <param name="FamilyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
/// <param name="GivenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///<remarks>
/// <para>This form of <c>setName</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Name</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetName(NameType Type, string FamilyName, string GivenName)
{
RemoveChild(CommonDTD.PERSONALINFORMATION_NAME);
AddChild(CommonDTD.PERSONALINFORMATION_NAME, new Name(Type, FamilyName, GivenName));
}
///<summary>Sets the value of the <c><Name></c> element.</summary>
/// <param name="Type">Code that specifies what type of name this is</param>
/// <param name="FamilyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
/// <param name="GivenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///<remarks>
/// <para>This form of <c>setName</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Name</c></para>
/// <para>Version: 2.5</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetName( NameType Type, string FamilyName, string GivenName )
{
RemoveChild( CommonDTD.CONTACTINFO_NAME);
AddChild( CommonDTD.CONTACTINFO_NAME, new Name( Type, FamilyName, GivenName ) );
}
/// <summary>
/// Sets the value of the <c>Type</c> attribute.
/// </summary>
/// <param name="val">A NameType object</param>
/// <remarks>
/// <para>The SIF specification defines the meaning of this attribute as: "Code that specifies what type of name this is"</para>
/// <para>Version: 2.5</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetType( NameType val )
{
SetField( CommonDTD.NAME_TYPE, val );
}
///<summary>Adds the value of the <c><Name></c> element.</summary>
/// <param name="Type">Code that specifies what type of name this is</param>
/// <param name="FamilyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
/// <param name="GivenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///<remarks>
/// <para>This form of <c>setName</c> is provided as a convenience method
/// that is functionally equivalent to the method <c>AddName</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void AddName(NameType Type, string FamilyName, string GivenName)
{
AddChild(CommonDTD.OTHERNAMES_NAME, new Name(Type, FamilyName, GivenName));
}
/// <summary>
/// Sets the value of the <c>Type</c> attribute.
/// </summary>
/// <param name="val">A NameType object</param>
/// <remarks>
/// <para>The SIF specification defines the meaning of this attribute as: "Code that specifies what type of name this is"</para>
/// <para>Version: 2.6</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetType(NameType val)
{
SetField(CommonDTD.NAME_TYPE, val);
}
/// <summary>
/// Constructor that accepts values for all mandatory fields
/// </summary>
///<param name="type">Code that specifies what type of name this is</param>
///<param name="familyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
///<param name="givenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///
public Name(NameType type, string familyName, string givenName) : base(CommonDTD.NAME)
{
this.SetType(type);
this.FamilyName = familyName;
this.GivenName = givenName;
}
///<summary>Sets the value of the <c><Name></c> element.</summary>
/// <param name="Type">Code that specifies what type of name this is</param>
/// <param name="FamilyName">Full legal family name. That part of the person's name which is used to describe family, clan, tribal group, or marital association. Note that this element is always required. However, when associated with a contact it may not be possible to know the family name in which case you should add the available information to the FullName element. CBDS: 100003, 100162, 100288, 100280, 900001</param>
/// <param name="GivenName">Full given name (forename) of the person. Note that this element is always required. However, when associated with a contact it may not be possible to know the given name in which case you should add the available information to the FullName element. CBDS: 100004, 100163, 100164, 100289, 100006, 100281, 900002</param>
///<remarks>
/// <para>This form of <c>setName</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Name</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetName(NameType Type, string FamilyName, string GivenName)
{
RemoveChild(CommonDTD.CONTACTINFO_NAME);
AddChild(CommonDTD.CONTACTINFO_NAME, new Name(Type, FamilyName, GivenName));
}