ParameterSectionLabel Property

LABEL: Represents the actual text that should be put on the mailing label, when delivering a physical package to the person/object associated with the VCard. ([2],[3],4)

Definition

Namespace: FolkerKinzel.VCards.Models.Properties.Parameters
Assembly: FolkerKinzel.VCards (in FolkerKinzel.VCards.dll) Version: 8.0.1+a91cc3f0fd39aeb548e16006a60ca9dd10a304a2
C#
public string? Label { get; set; }

Property Value

String

Remarks

In the vCard standards 2.1 and 3.0, ADR and LABEL are separate vCard properties. Only as of vCard 4.0 they are permanently linked to one another. When saving a vCard 2.1 and vCard 3.0, the content of this property is automatically inserted into the vCard as a separate LABEL property. It's recommended in this case to assign a Group identifier to the AddressProperty: The LABEL property will get the same automatically.

  Caution

When loading a vCard 2.1 or 3.0, the library tries to create the link between LABEL and ADR based on matching Group identifiers and parameters of both properties. A text comparison of the content of ADR and LABEL does not take place for performance reasons.

Although the correct assignment is usually successful in this way, this cannot be guaranteed for every scenario. If the assignment of ADR and LABEL plays an important role for the application, the application should check this in the case of vCard 2.1 or vCard 3.0 by text comparison or create its own labels from the Address data, e.g., using the AddressFormatter class.

See Also