RelationBuilderAdd(VCard, NullableRel, ActionParameterSection, FuncVCard, String) Method
Adds a
RelationProperty instance, which is newly initialized using the
VCard-object that represents a person or organization, to the specified
property of the
VCard.
Namespace: FolkerKinzel.VCards.BuilderPartsAssembly: FolkerKinzel.VCards (in FolkerKinzel.VCards.dll) Version: 8.0.1+a91cc3f0fd39aeb548e16006a60ca9dd10a304a2
public VCardBuilder Add(
VCard? vCard,
Rel? relationType = null,
Action<ParameterSection>? parameters = null,
Func<VCard, string?>? group = null
)
Public Function Add (
vCard As VCard,
Optional relationType As Rel? = Nothing,
Optional parameters As Action(Of ParameterSection) = Nothing,
Optional group As Func(Of VCard, String) = Nothing
) As VCardBuilder
public:
VCardBuilder^ Add(
VCard^ vCard,
Nullable<Rel> relationType = nullptr,
Action<ParameterSection^>^ parameters = nullptr,
Func<VCard^, String^>^ group = nullptr
)
member Add :
vCard : VCard *
?relationType : Nullable<Rel> *
?parameters : Action<ParameterSection> *
?group : Func<VCard, string>
(* Defaults:
let _relationType = defaultArg relationType null
let _parameters = defaultArg parameters null
let _group = defaultArg group null
*)
-> VCardBuilder
- vCard VCard
- The VCard-object that represents a person or organization
to whom there is a relationship, or null.
- relationType NullableRel (Optional)
- Standardized description of the relationship with the person
or organization that the vCard represents.
The RelationType property of the added instance will be set to this
value.
- parameters ActionParameterSection (Optional)
- An ActionT delegate that's invoked with the
ParameterSection of the newly created VCardProperty as argument.
- group FuncVCard, String (Optional)
- A function that returns the identifier of the group of VCardProperty
objects, which the VCardProperty should belong to, or null to indicate that
the VCardProperty does not belong to any group. The function is called with the
VCard instance as argument.
VCardBuilderThe
VCardBuilder instance that initialized this
RelationBuilder
to be able to chain calls.
vCard 2.1 and vCard 3.0 can embed nested vCards if the flag
Agent is
set in their
RelationType property. When serializing a vCard 4.0,
embedded
VCards will be automatically replaced by their
ContactID
references and appended as separate vCards to the VCF file.