vCardLib.dll 5.0.0

dotnet add package vCardLib.dll --version 5.0.0
NuGet\Install-Package vCardLib.dll -Version 5.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="vCardLib.dll" Version="5.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add vCardLib.dll --version 5.0.0
#r "nuget: vCardLib.dll, 5.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install vCardLib.dll as a Cake Addin
#addin nuget:?package=vCardLib.dll&version=5.0.0

// Install vCardLib.dll as a Cake Tool
#tool nuget:?package=vCardLib.dll&version=5.0.0

vCardLib

Coverage Status NET Standard NuGet Badge License: MIT

<br/>

This master branch contains the latest changes and features (which are breaking) to see the last major release ( v4) click here

This library supports reading multiple contacts from a single vcf file, a stream or a contact string and returns the contact objects in an Enumerable. The library currently supports only vCard version 2.1 and 3.0 (a curated list of properties supported can be seen on the documentation site).

How to use the library:

First get this package from nuget via your package manager:

Install-Package vCardLib.dll

or

dotnet add package vCardLib.dll

For Deserialization

Deserialize from a file

string filePath = // path to vcf file;
IEnumerable<vCard> contacts = vCardDeserializer.FromFile(filePath);

Deserialize from a Stream

var stream = // generate stream containing serialized vcards
IEnumerable<vCard> contacts = vCardDeserializer.FromStream(stream);

Deserialize from a string

var contactDetails = @"BEGIN:VCARD
VERSION:2.1
N:John;Doe;;;
END:VCARD";
IEnumerable<vCard> contacts = vCardDeserializer.FromContent(contactDetails);

For Serialization

Serialize as string

var vcard = new vCard(vCardVersion.v2)
{
    FormattedName = "John Doe"
};
var serialized = vCardSerializer.Serialize(vcard);

/*
BEGIN:VCARD
VERSION:2.1
REV:20230719T001838Z
FN:John Doe
END:VCARD
 */

Serialize with an override

This allows a vcard to get serialized to a different version

var vcard = new vCard(vCardVersion.v2)
{
    FormattedName = "John Doe"
};
var serialized = vCardSerializer.Serialize(vcard, vCardVersioon.v4);

/*
BEGIN:VCARD
VERSION:4.0
REV:20230719T001838Z
FN:John Doe
END:VCARD
 */

Contributors

A huge thank you to these wonderful people who took time to contribute to this project.

<br/>

@bolorundurowb, @crowar , @rmja, @JeanCollas

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard1.3 is compatible.  netstandard1.4 was computed.  netstandard1.5 was computed.  netstandard1.6 was computed.  netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Universal Windows Platform uap was computed.  uap10.0 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.0.0 373 2/15/2024
4.0.4 4,128 7/19/2023
4.0.3 8,701 6/26/2022
4.0.2 434 6/22/2022
4.0.1 1,603 1/3/2022
4.0.0 400 12/12/2021
3.0.5 301 1/3/2022
3.0.4 294 12/12/2021
3.0.3 1,891 11/28/2021
3.0.2 518 10/11/2021
3.0.1 7,325 7/4/2020
3.0.0 604 5/31/2020
2.2.6 1,121 8/23/2019
2.2.5 1,597 2/8/2018
2.2.4 982 1/1/2018
2.2.3 1,050 11/28/2017
2.2.2 1,342 8/10/2017
2.2.1 1,163 3/17/2017
2.2.0 1,143 2/26/2017
2.1.2 1,264 12/19/2016
2.1.1 1,019 12/14/2016
2.1.0 1,413 9/15/2016
2.0.0 1,074 6/11/2016
1.1.3 1,011 6/6/2016
1.1.2 994 6/1/2016
1.1.1 1,134 5/9/2016
1.1.0 1,280 4/27/2016
1.0.0 1,832 4/23/2016

- Full rewrite with performance upgrade
           - stability fixes
           - compliance with standards
           - vcard 4.0 serialization and deserialization support