Name Property Class
This class is used to represent the Name (N) property of a vCard
Definition
Namespace: EWSoftware.PDI.Properties
Assembly: EWSoftware.PDI.Data (in EWSoftware.PDI.Data.dll) Version: 2025.1.9.0
Assembly: EWSoftware.PDI.Data (in EWSoftware.PDI.Data.dll) Version: 2025.1.9.0
C#
public class NameProperty : BasePropertyVB
Public Class NameProperty
Inherits BasePropertyC++
public ref class NameProperty : public BasePropertyF#
type NameProperty =
class
inherit BaseProperty
end- Inheritance
- Object PDIObject BaseProperty NameProperty
Remarks
This property class parses the Value property and allows access to the component
name parts. It is based on the semantics of the X.520 individual name attributes.
Constructors
| NameProperty | Constructor |
Properties
| AdditionalNames | This property is used to set or get additional names such as one or more middle names |
| CharacterSet |
This is used to set or get the character set used for the value
(Inherited from BaseProperty) |
| CustomParameters |
This property is used to set or get a string containing custom parameters that are not part of the
specification. These are usually prefixed with "X-" to indicate an extension.
(Inherited from BaseProperty) |
| DefaultValueLocation |
This read-only property defines the default value type as TEXT
(Overrides BasePropertyDefaultValueLocation) |
| EncodedValue |
This property is overridden to handle parsing the name components and concatenating them when
requested.
(Overrides BasePropertyEncodedValue) |
| EncodingMethod |
Set or get the encoding method for this property's value as a value in the EncodingType
enumeration.
(Inherited from BaseProperty) |
| EncodingString |
Set or get the encoding method for this property's value as a string
(Inherited from BaseProperty) |
| FamilyName | This property is used to set or get the family name (last name) |
| FormattedName | This read-only property can be used to get the full, formatted name |
| GivenName | This property is used to set or get the given name (first name) |
| Group |
The group to which this property belongs
(Inherited from BaseProperty) |
| Language |
This is used to set or get the language used for the value
(Inherited from BaseProperty) |
| NamePrefix | This property is used to set or get the name prefix (i.e. Mr., Mrs.) |
| NameSuffix | This property is used to set or get the name suffix (i.e. Jr, Sr) |
| PropertyId |
This is used to get or set the property ID for the value
(Inherited from BaseProperty) |
| SortableName | This read-only property can be used to get the name in a format suitable for sorting by last name |
| SortAs | This property is used to set or get the string to use when sorting names |
| Tag |
This read-only property defines the tag (N)
(Overrides BasePropertyTag) |
| Value |
This property is overridden to handle parsing the name components and concatenating them when
requested.
(Overrides BasePropertyValue) |
| ValueLocation |
The value (data) type or location of this property's value
(Inherited from BaseProperty) |
| Version |
This is overridden to enforce the correct encoding type when the version changes
(Inherited from BaseProperty) |
| VersionsSupported |
This is used to establish the specification versions supported by the PDI object
(Overrides PDIObjectVersionsSupported) |
Methods
| Clone |
This is overridden to allow cloning of a PDI object
(Overrides PDIObjectClone) |
| Clone(PDIObject) |
This is overridden to allow copying values from the specified PDI object into the instance
(Inherited from BaseProperty) |
| Decode |
This method is used to decode a value read in from a PDI data stream
(Inherited from BaseProperty) |
| DeserializeParameters |
This is overridden to provide custom handling of the SORT-AS parameter
(Overrides BasePropertyDeserializeParameters(StringCollection)) |
| Encode |
This method is used to encode a value for output to a PDI data stream
(Inherited from BaseProperty) |
| Equals |
This is overridden to allow proper comparison of property objects
(Inherited from BaseProperty) |
| 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 |
Get a hash code for the property object
(Inherited from BaseProperty) |
| GetType | Gets the Type of the current instance. (Inherited from Object) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object) |
| SerializeCharacterSet |
This is called to serialize the CHARSET parameter if necessary
(Inherited from BaseProperty) |
| SerializeCustomParameters |
This is called to serialize any custom parameters if necessary
(Inherited from BaseProperty) |
| SerializeEncoding |
This is called to serialize the ENCODING parameter if necessary
(Inherited from BaseProperty) |
| SerializeLanguage |
This is called to serialize the LANGUAGE parameter if necessary
(Inherited from BaseProperty) |
| SerializeParameters |
This is overridden to provide custom handling of the SORT-AS parameter
(Overrides BasePropertySerializeParameters(StringBuilder)) |
| SerializePropertyId |
This is called to serialize the PID parameter if necessary
(Inherited from BaseProperty) |
| SerializeValueLocation |
This is called to serialize the value location parameter if necessary
(Inherited from BaseProperty) |
| ToString |
This is overridden to convert the instance to a string
(Inherited from BaseProperty) |
| ToString(StringBuilder) |
This is used to convert the property instance to a format suitable for writing to a PDI data stream
(Inherited from BaseProperty) |