/// <summary>
/// Constructor that accepts values for all mandatory fields
/// </summary>
///<param name="type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
///<param name="street">The street part of the address</param>
///<param name="city">The city part of the address.</param>
///<param name="stateProvince">The state or province code.</param>
///<param name="country">The country code.</param>
///<param name="postalCode">The ZIP/postal code.</param>
///
public Address( AddressType type, Street street, string city, StatePrCode stateProvince, CountryCode country, string postalCode )
: base(CommonDTD.ADDRESS)
{
this.SetType( type );
this.Street = street;
this.City = city;
this.SetStateProvince( stateProvince );
this.SetCountry( country );
this.PostalCode = postalCode;
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.5</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public void SetAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
RemoveChild( StudentDTD.STUDENTSNAPSHOT_ADDRESS);
AddChild( StudentDTD.STUDENTSNAPSHOT_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public void SetAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
RemoveChild( InstrDTD.SOURCEAUTHOR_ADDRESS);
AddChild( InstrDTD.SOURCEAUTHOR_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
/// <summary>
/// Removes an <see cref="Address"/> object instance. More than one instance can be defined for this object because it is a repeatable field element.
/// </summary>
/// <param name="Type">Identifies the Address object to remove by its Type value</param>
/// <remarks>
/// <para>Version: 2.5</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public void RemoveAddress( AddressType Type )
{
RemoveChild( ReportingDTD.STUDENTLOCATOR_ADDRESS, new String[] { Type.ToString() } );
}
/// <summary>
/// Gets an <see cref="Address"/> object instance. More than one instance can be defined for this object because it is a repeatable field element.
/// </summary>
/// <param name="Type">Identifies the Address object to return by its "Type" attribute value</param>
/// <returns>An Address object</returns>
/// <remarks>
/// <para>Version: 2.5</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public Address GetAddress( AddressType Type )
{
return (Address)GetChild( ReportingDTD.STUDENTLOCATOR_ADDRESS, new string[] { Type.ToString() } );
}
///<summary>Adds the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the method <c>AddAddress</c></para>
/// <para>Version: 2.5</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public void AddAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
AddChild( ReportingDTD.STUDENTLOCATOR_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
RemoveChild( CommonDTD.CONTACTINFO_ADDRESS);
AddChild( CommonDTD.CONTACTINFO_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.5</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
RemoveChild( AssessmentDTD.ASSESSMENTADMINISTRATION_ADDRESS);
AddChild( AssessmentDTD.ASSESSMENTADMINISTRATION_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
/// <summary>
/// Sets the value of the <c>Type</c> attribute.
/// </summary>
/// <param name="val">A AddressType object</param>
/// <remarks>
/// <para>The SIF specification defines the meaning of this attribute as: "Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object."</para>
/// <para>Version: 2.5</para>
/// <para>Since: 1.1</para>
/// </remarks>
public void SetType( AddressType val )
{
SetField( CommonDTD.ADDRESS_TYPE, val );
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public void SetAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
RemoveChild( ReportingDTD.REPORTSUBMITTERINFO_ADDRESS);
AddChild( ReportingDTD.REPORTSUBMITTERINFO_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.5</para>
/// <para>Since: 1.5r1</para>
/// </remarks>
public void SetAddress( AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode )
{
RemoveChild( ProfdevDTD.ACTIVITYPROVIDER_ADDRESS);
AddChild( ProfdevDTD.ACTIVITYPROVIDER_ADDRESS, new Address( Type, Street, City, StateProvince, Country, PostalCode ) );
}
/// <summary>
/// Sets the value of the <c>Type</c> attribute.
/// </summary>
/// <param name="val">A AddressType object</param>
/// <remarks>
/// <para>The SIF specification defines the meaning of this attribute as: "Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object."</para>
/// <para>Version: 2.6</para>
/// <para>Since: 1.1</para>
/// </remarks>
public void SetType(AddressType val)
{
SetField(CommonDTD.ADDRESS_TYPE, val);
}
///<summary>Sets the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the <c>Address</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 2.0</para>
/// </remarks>
public void SetAddress(AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode)
{
RemoveChild(CommonDTD.CONTACTINFO_ADDRESS);
AddChild(CommonDTD.CONTACTINFO_ADDRESS, new Address(Type, Street, City, StateProvince, Country, PostalCode));
}
///<summary>Adds the value of the <c><Address></c> element.</summary>
/// <param name="Type">Code that defines the location of the address. Note: A subset of specific valid values for each instance in a data object may be listed in that object.</param>
/// <param name="Street">The street part of the address</param>
/// <param name="City">The city part of the address.</param>
/// <param name="StateProvince">The state or province code.</param>
/// <param name="Country">The country code.</param>
/// <param name="PostalCode">The ZIP/postal code.</param>
///<remarks>
/// <para>This form of <c>setAddress</c> is provided as a convenience method
/// that is functionally equivalent to the method <c>AddAddress</c></para>
/// <para>Version: 2.6</para>
/// <para>Since: 1.1</para>
/// </remarks>
public void AddAddress(AddressType Type, Street Street, string City, StatePrCode StateProvince, CountryCode Country, string PostalCode)
{
AddChild(CommonDTD.ADDRESSLIST_ADDRESS, new Address(Type, Street, City, StateProvince, Country, PostalCode));
}
