DataStandardizer.File.vCard
2.0.0
Prefix Reserved
dotnet add package DataStandardizer.File.vCard --version 2.0.0
NuGet\Install-Package DataStandardizer.File.vCard -Version 2.0.0
<PackageReference Include="DataStandardizer.File.vCard" Version="2.0.0" />
<PackageVersion Include="DataStandardizer.File.vCard" Version="2.0.0" />
<PackageReference Include="DataStandardizer.File.vCard" />
paket add DataStandardizer.File.vCard --version 2.0.0
#r "nuget: DataStandardizer.File.vCard, 2.0.0"
#:package DataStandardizer.File.vCard@2.0.0
#addin nuget:?package=DataStandardizer.File.vCard&version=2.0.0
#tool nuget:?package=DataStandardizer.File.vCard&version=2.0.0
Introduction
Data Standardizer provides implementations of various internationally recognised standards in data processing, covering topics ranging from languages to currencies and geographical entities. With strongly-typed enumerations for each standard (where applicable) or other targeted data types, you can represent these elements in your code such that errors with invalid values are minimised.
Supported target platforms include (modern) .Net and .Net Standard. Data Standardizer can be used in modern application software, but is also available as an option for older codebases that are being upgraded more gradually or may remain on older frameworks indefinitely.
📚 Documentation
Full documentation — user guides, concepts, and API reference for every package — is published at matthew25187.github.io/DataStandardizer.
Supporting the project
If you derive a commercial benefit from use of Data Standardizer or feel it otherwise adds value to your project, you are asked to please consider supporting the project. You can do this by becoming a GitHub sponsor to make a financial contribution. Data Standardizer is maintained and enhanced by @matthew25187 in his personal time and made available for free for all to use.
Getting Started
Installation
Data Standardizer is available as a series of packages from NuGet.org that can be linked to your existing projects. Available packages include:
| Package | Description |
|---|---|
| DataStandardizer.Chronology | Supports the following standards:<ul><li>TZ Database</li><li>Unix time</li><li>DOS date & time</li></ul> |
| DataStandardizer.Communication | Supports the following standards:<ul><li>Recommendation ITU-T E.164, The international public telecommunication numbering plan</li><li>MIME, as defined by:<ul><li>RFC 2045, Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies</li><li>RFC 2046, Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</li><li>RFC 2047, MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text</li><li>RFC 2231, MIME Parameter Value and Encoded Word Extensions: Character Sets, Languages, and Continuations</li><li>RFC 2397, The "data" URL scheme</li><li>RFC 2978, IANA Charset Registration Procedures</li><li>RFC 4289, Multipurpose Internet Mail Extensions (MIME) Part Four: Registration Procedures</li><li>RFC 4648, The Base16, Base32, and Base64 Data Encodings</li><li>RFC 6657, Update to MIME regarding "charset" Parameter Handling in Textual Media Types</li><li>RFC 6838, Media Type Specifications and Registration Procedures</li><li>RFC 6839, Additional Media Type Structured Syntax Suffixes</li></ul></li></ul> |
| DataStandardizer.Core | Common types used to implement standards in the other packages. You should not need to link to this package directly. |
| DataStandardizer.File.CSV | Supports the following standards:<ul><li>RFC 4180, Common Format and MIME Type for Comma-Separated Values (CSV) Files</li></ul> |
| DataStandardizer.File.iCal | Supports the following standards:<ul><li>RFC 5545, Internet Calendaring and Scheduling Core Object Specification (iCalendar)</li><li>RFC 6868, Parameter Value Encoding in iCalendar and vCard</li><li>RFC 7986, New Properties for iCalendar</li><li>RFC 7265, jCal: The JSON Format for iCalendar</li><li>RFC 6321, xCal: The XML Format for iCalendar</li></ul> |
| DataStandardizer.File.InternetMessage | Supports the following standards:<ul><li>RFC 5322, Internet Message Format</li><li>RFC 6532, Internationalized Email Headers</li><li>RFC 6854, Update to Internet Message Format to Allow Group Syntax in the "From:" and "Sender:" Header Fields</li><li>MIME in a message, as defined by:<ul><li>RFC 2045, Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies</li><li>RFC 2046, Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</li><li>RFC 2047, MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text</li><li>RFC 2183, Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field</li><li>RFC 2231, MIME Parameter Value and Encoded Word Extensions: Character Sets, Languages, and Continuations</li><li>RFC 2387, The MIME Multipart/Related Content-type</li><li>RFC 2392, Content-ID and Message-ID Uniform Resource Locators</li><li>RFC 3282, Content Language Headers</li></ul></li><li>RFC 2557, MIME Encapsulation of Aggregate Documents, such as HTML (MHTML)</li><li>RFC 4155, The application/mbox Media Type</li><li>Apple Mail EMLX files, which have no published standard</li></ul> |
| DataStandardizer.File.vCard | Supports the following standards:<ul><li>RFC 6350, vCard Format Specification</li><li>RFC 6868, Parameter Value Encoding in iCalendar and vCard</li><li>RFC 7095, jCard: The JSON Format for vCard</li><li>RFC 6351, xCard: vCard XML Representation</li><li>vCard 2.1, The Electronic Business Card</li><li>RFC 2425, A MIME Content-Type for Directory Information, and RFC 2426, vCard MIME Directory Profile (vCard 3.0)</li><li>RFC 2739, Calendar Attributes for vCard and LDAP</li><li>RFC 4770, vCard Extensions for Instant Messaging (IM)</li><li>RFC 9554, vCard Format Extensions for JSContact</li><li>RFC 6473, vCard KIND:application, and RFC 6869, vCard KIND:device</li><li>RFC 6474, vCard Format Extensions: Place of Birth, Place and Date of Death</li><li>RFC 6715, vCard Format Extensions: Representing vCard Extensions Defined by the Open Mobile Alliance (OMA) Converged Address Book (CAB) Group</li><li>RFC 8605, vCard Format Extensions: ICANN Extensions for the Registration Data Access Protocol (RDAP)</li></ul> |
| DataStandardizer.Geography | Supports the following standards:<ul><li>ISO 3166-1, Codes for the representation of names of countries and their subdivisions – Part 1: Country code</li><li>ISO 3166-2, Codes for the representation of names of countries and their subdivisions – Part 2: Country subdivision code</li><li>UN M49, Standard Country or Area Codes for Statistical Use (Series M, No. 49)</li></ul> |
| DataStandardizer.Language | Supports the following standards:<ul><li>ISO 639, Code for the representation of names of languages</li><ul><li>Part 1: Alpha-2 code</li><li>Part 2: Alpha-3 code</li><li>Part 3: Alpha-3 code for comprehensive coverage of languages</li><li>Part 5: Alpha-3 code for language families and groups</li></ul><li>ISO 15924, Codes for the representation of names of scripts</li></ul> |
| DataStandardizer.LanguageTag | Supports the following standards:<ul><li>IETF BCP 47 language tags, as defined by:<ul><li>RFC 5646, Tags for Identifying Languages, including well-formed and valid tags, and the IANA Language Subtag Registry format</li></ul></li></ul> |
| DataStandardizer.Money | Supports the following standards:<ul><li>ISO 4217, Codes for the representation of currencies and funds</li><ul><li>Table A.1 – Current currency & funds code list</li><li>Table A.2 – Current funds codes</li><li>Table A.3 – List of codes for historic denominations of currencies & funds</li></ul><li>Money type, as described in Patterns of Enterprise Application Architecture by Martin Fowler</li></ul> |
To use a particular standard in your application, find the corresponding package from the above list and add it as a dependency to your project. Instructions for doing so will depend on what development tooling you are using.
- Visual Studio: see Install and manage packages in Visual Studio using the NuGet Package Manager
- .Net CLI: see Install and manage NuGet packages with the dotnet CLI
- Visual Studio Code: see NuGet in Visual Studio Code
See the Get started guide for step-by-step installation and a quickstart.
Software dependencies
Depending on which .Net platform you are targeting, the above packages will also depend on various other system- and third-party packages. They will be included as static dependencies where required and should be automatically resolved, but if you are using a proxy for your package server you may need to make sure these other packages are also available. For example, the netstandard1.1 and netstandard2.0 builds of DataStandardizer.LanguageTag depend on System.Memory for their span-based API.
Latest releases
The promoted version is the latest release promoted from this repository's builds (a GitHub Release). It does not necessarily correspond with the latest package version published to NuGet or any other publically available source.
Build and test
Data Standardizer is open source so you can read, build, and adapt it for your own use. The project does not currently accept third-party code contributions; the instructions below are provided as a convenience for working with your own copy or fork of the repository.
After cloning the repository, you can compile the entire solution from the repository root:
dotnet build DataStandardizer.sln
and run the XUnit-based tests with:
dotnet test DataStandardizer.sln
Per-package solution filter (*.slnf) files let you build or test a single package in isolation. For the full branching strategy, per-package builds, IDE testing, and the PowerShell scripts that regenerate the standard enums, see Build from source in the documentation.
Usage
Though each package contains many types, typically there are only a few you will use directly in your application. See the project documentation for user guides, concepts, and API reference covering each package — including built-in CSV reading, writing, and normalization in DataStandardizer.File.CSV, iCalendar reading, writing, and recurrence expansion in DataStandardizer.File.iCal, reading and writing of Internet messages in EML, MHTML, mbox and EMLX files in DataStandardizer.File.InternetMessage, and reading, writing and conversion of vCard 4.0, 3.0 and 2.1 cards, jCard and xCard in DataStandardizer.File.vCard.
| Product | Versions 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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.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.1 is compatible. netstandard1.2 was computed. netstandard1.3 was computed. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 is compatible. |
| .NET Framework | net45 was computed. net451 was computed. net452 was computed. 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. |
| Windows Phone | wpa81 was computed. |
| Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 1.1
- DataStandardizer.Communication (>= 2.0.0)
- DataStandardizer.Core (>= 2.0.0)
- DataStandardizer.LanguageTag (>= 2.0.0)
- NETStandard.Library (>= 2.0.3)
- System.Memory (= 4.5.5)
- System.Net.Http (>= 4.3.4)
-
.NETStandard 2.0
- DataStandardizer.Communication (>= 2.0.0)
- DataStandardizer.Core (>= 2.0.0)
- DataStandardizer.LanguageTag (>= 2.0.0)
- Microsoft.Bcl.AsyncInterfaces (>= 10.0.14)
- System.Memory (>= 4.6.3)
- System.Text.Json (>= 10.0.14)
-
.NETStandard 2.1
- DataStandardizer.Communication (>= 2.0.0)
- DataStandardizer.Core (>= 2.0.0)
- DataStandardizer.LanguageTag (>= 2.0.0)
- System.Text.Json (>= 10.0.14)
-
net10.0
- DataStandardizer.Communication (>= 2.0.0)
- DataStandardizer.Core (>= 2.0.0)
- DataStandardizer.LanguageTag (>= 2.0.0)
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 |
|---|---|---|
| 2.0.0 | 92 | 11/10/2026 |
New:
- `VcardContentLineReader` reads the content lines of vCard data (RFC 6350 §3.3), with groups and RFC 6868 caret encoding, synchronously or asynchronously, with a zero-copy `VcardContentLineView`.
- `VcardContentLineWriter` writes the content lines of vCard data, with groups, folding at 75 octets and RFC 6868 caret encoding in vCard 4.0 cards, synchronously or asynchronously, with `IProgress<VcardWriteProgress>`.
- In a vCard 2.1 card, `VcardContentLineReader` reads parameters with no name, quoted-printable soft line breaks, `BASE64` values ending at an empty line and nested `AGENT` cards, and `VcardContentLineWriter` writes soft line breaks and `BASE64` values.
- `VcardContentLine` and `VcardContentLineView` decode a value by its `ENCODING` and `CHARSET` with `GetDecodedValue` and `GetDecodedText`, and `LegacySyntax` says which vCard 2.1 features a line uses.
- `VcardOptions` adds `AcceptLegacySyntax`, `AcceptRfc6350FoldsInVersion21`, `AcceptEightBitWithoutEncoding`, `AllowUnknownCharsetAsLatin1` and `CharsetResolver`.
- Parse and format vCard values with typed, span-based value types.
- Read and write vCard 4.0 cards with VcardCard, VcardReader and VcardWriter.
- Read and write the vCard 4.0 extensions of RFC 6473, RFC 6474, RFC 6715, RFC 6869 and RFC 8605, with typed members on `VcardCard` and `IVcard40Card`.
- Read and write the vCard 4.0 extensions of RFC 9554, including `CREATED`, `GRAMGENDER`, `LANGUAGE`, `PRONOUNS`, `SOCIALPROFILE` and their parameters, with typed members on `VcardCard` and `IVcard40Card`.
- Read and write vCard 3.0 cards (RFC 2426, RFC 2739 and RFC 4770) with `VcardReader` and `VcardOptions.WriteVersion`, and view them through `IVcard30Card`.
- `VcardVersionConverter` lists what a card loses in another version and converts it, and writing data the version can't hold throws unless `AllowLossyVersionConversion` is set.
- `VcardCard` has `Mailer`, `Classification`, `SourceName`, `Profile`, `CalendarAccessUris` and `Agents` for the properties of older versions.
- Read and write vCard 2.1 cards, including quoted-printable, `CHARSET`, `BASE64` and the card an `AGENT` holds, with `VcardReader` and `VcardOptions.WriteVersion`, and view them through `IVcard21Card`.
- `VcardOptions.WriteNamedTypesInVersion21` writes each `TYPE` of a vCard 2.1 card with its name, as `TEL;TYPE=WORK:`.
- `JcardReader` and `JcardWriter` read and write jCard (RFC 7095), the JSON form of vCard, on .NET Standard 2.0 and later.
- The date, time, offset, TEXT, BOOLEAN, INTEGER, FLOAT, URI, LANGUAGE-TAG, GEO and PID values parse and format `VcardValueFormat.Json`, the jCard form of their values, on every target.
- `XcardReader` and `XcardWriter` read and write xCard (RFC 6351), the XML form of vCard, on every target.
- The date, time, offset, TEXT, BOOLEAN, INTEGER, FLOAT, URI, LANGUAGE-TAG, GEO and PID values parse and format `VcardValueFormat.Xml`, the xCard form of their values.