IcalValueFormat Enum
Definition
Namespace: DataStandardizer.File.iCal
The lexical form in which a value is parsed or formatted. The value types hold structured data, so one value can be written in any of these forms.
Syntax
public enum IcalValueFormat
Remarks
The parse and format members of the value types take an IcalValueFormat, such as IcalDateTime.Parse, IcalValue.TryParseInteger and IcalValue.TryFormatText. They throw ArgumentOutOfRangeException for a value that isn’t one of the members below.
var start = IcalDateTime.Parse("2011-05-17T12:00:00Z", IcalValueFormat.Xml);
var text = start.ToString(IcalValueFormat.Text); // "20110517T120000Z"
Json form. A value is the text of a JSON string with its JSON escaping removed, or the text of a JSON number or literal.
- TEXT values have no iCalendar escaping, and a list is one item, since each item is its own JSON string.
- BOOLEAN values are
trueorfalse, in lower case. - INTEGER and FLOAT values are JSON numbers, which have no plus sign or leading zeros and may have an exponent. An INTEGER may have a fraction or an exponent as long as the number is a whole one, such as
1.0or1e2. - DATE, TIME, DATE-TIME and UTC-OFFSET values are as in
Xmlform. DURATION, BINARY, URI and CAL-ADDRESS values are as inTextform. - A PERIOD is the start and the end or duration joined by a solidus, as in
Xmlform. In a jCal document they are the two strings of an array. - A RECUR value has no form of its own, since in a jCal document it is a JSON object. So IcalRecurrenceRule throws
NotSupportedExceptionfor this form. JcalReader and JcalWriter handle the array and the object.
This form needs no JSON library, so the value types support it on every target, netstandard1.1 included. Only JcalReader and JcalWriter need System.Text.Json.
Xml form. A value is the content of an xCal value element.
- TEXT values have no escaping, and a list is one item, since each item is its own element.
- BOOLEAN values are
trueorfalse. - DURATION, INTEGER, FLOAT, BINARY, URI and CAL-ADDRESS values are as in
Textform. - Parsing accepts what the XML Schema types of RFC 6321 allow: white space around a BOOLEAN, INTEGER, FLOAT, URI or CAL-ADDRESS value, and anywhere in a BINARY value. DATE, TIME, DATE-TIME, DURATION and UTC-OFFSET are patterned
xsd:stringtypes, which keep white space, so a value of one of those types with white space around it is not valid. - A PERIOD is the start and the end or duration joined by a solidus, as in
Textform. In an xCal document they are separate elements. - A RECUR value has no form of its own, since in an xCal document each rule part is an element. So
IcalRecurrenceRulethrowsNotSupportedExceptionfor this form. XcalReader and XcalWriter handle those elements.
Fields
| Field | Value | Meaning |
|---|---|---|
Text | 0 | The text form of RFC 5545, used in .ics content lines; for example 20130101T120000Z or -0500. |
Json | 1 | The jCal form of RFC 7265, the text of a JSON value, which uses extended ISO 8601; for example 2013-01-01T12:00:00Z or -05:00. |
Xml | 2 | The xCal form of RFC 6321, the content of a value element, which uses extended ISO 8601; for example 2013-01-01T12:00:00Z or -05:00. |
Applies to
Targets netstandard1.1, netstandard2.0, netstandard2.1, and net10.0.