IsEmpty
Added in v34.0.0
public bool IsEmpty { get; }Whether the value is empty.
Property value
bool
Ref struct in CsvHelper
CsvField
Added in v34.0.0
One field of the current record. The value is already unquoted and unescaped.
public readonly ref struct CsvField- Namespace
CsvHelper- Assembly
CsvHelper.dll- Builds
- net10.0 netstandard2.1 netstandard2.0 net47
- Source
- CsvRow.cs
Properties
Length
Added in v34.0.0
public int Length { get; }The length of the value in bytes.
Property value
int
Span
Added in v34.0.0
public ReadOnlySpan<byte> Span { get; }The field value as UTF-8 bytes. Valid until the next read.
Property value
ReadOnlySpan<byte>
Methods
Parse<T>()
Added in v34.0.0
net10.0
public T Parse<T>() where T : ISpanParsable<T>Parses the value as T. See CsvReader.Parse<T>(int).
Type parameters
T- The type to parse the value as.
Returns
T
The parsed value.
Exceptions
- FormatException
- The value is not a valid
T. - OverflowException
- The value is outside the range of
T. - NotSupportedException
- On .NET Framework and .NET Standard,
Tis not one of the built-in types.
netstandard2.1, netstandard2.0, net47
public T Parse<T>()Parses the value as T. See CsvReader.Parse<T>(int).
Type parameters
T- The type to parse the value as.
Returns
T
The parsed value.
Exceptions
- FormatException
- The value is not a valid
T. - OverflowException
- The value is outside the range of
T. - NotSupportedException
- On .NET Framework and .NET Standard,
Tis not one of the built-in types.
Parse<T>(Func<string, IFormatProvider, T>)
Added in v34.0.0
public T Parse<T>(Func<string, IFormatProvider, T> parser)Parses the value with parser, which gets it as a string and the reader's format provider.
Type parameters
T- The type that
parserreturns.
Parameters
parserFunc<string, IFormatProvider, T>- Parses the value with the given format provider.
Returns
T
The value that
parser returns.Exceptions
- ArgumentNullException
parserisnull.
ParseOrNull<T>()
Added in v34.0.0
net10.0
public T? ParseOrNull<T>() where T : struct, ISpanParsable<T>Parses the value as T, or returns null if it is empty, one of CsvReaderOptions.NullValues or invalid.
Type parameters
T- The type to parse the value as.
Returns
T?
The parsed value, or
null when the value is null or not a valid T.Exceptions
- NotSupportedException
- On .NET Framework and .NET Standard,
Tis not one of the built-in types.
netstandard2.1, netstandard2.0, net47
public T? ParseOrNull<T>() where T : structParses the value as T, or returns null if it is empty, one of CsvReaderOptions.NullValues or invalid.
Type parameters
T- The type to parse the value as.
Returns
T?
The parsed value, or
null when the value is null or not a valid T.Exceptions
- NotSupportedException
- On .NET Framework and .NET Standard,
Tis not one of the built-in types.
ParseOrNull<T>(CsvTryParser<T>)
Added in v34.0.0
public T? ParseOrNull<T>(CsvTryParser<T> parser) where T : structParses the value with parser, or returns null if it is empty, one of CsvReaderOptions.NullValues, or parser fails.
Type parameters
T- The type that
parserparses.
Parameters
parserCsvTryParser<T> where T : struct- Tries to parse the value with the reader's format provider. It is not called for a null value.
Returns
T?
The parsed value, or
null when the value is null or parser fails.Exceptions
- ArgumentNullException
- The value is not null and
parserisnull.
ToString()
Added in v34.0.0
public override string ToString()Gets the value as a string. See CsvReader.GetString(int).
Returns
string
The value; string.Empty for an empty field.
TryParse<T>(out T)
Added in v34.0.0
net10.0
public bool TryParse<T>(out T value) where T : ISpanParsable<T>Tries to parse the value as T. See CsvReader.Parse<T>(int).
Type parameters
T- The type to parse the value as.
Parameters
valueT- The parsed value, or the default of
Twhen parsing fails.
Returns
bool
Whether the value could be parsed.
Exceptions
- NotSupportedException
- On .NET Framework and .NET Standard,
Tis not one of the built-in types.
netstandard2.1, netstandard2.0, net47
public bool TryParse<T>(out T value)Tries to parse the value as T. See CsvReader.Parse<T>(int).
Type parameters
T- The type to parse the value as.
Parameters
valueT- The parsed value, or the default of
Twhen parsing fails.
Returns
bool
Whether the value could be parsed.
Exceptions
- NotSupportedException
- On .NET Framework and .NET Standard,
Tis not one of the built-in types.
TryParse<T>(CsvTryParser<T>, out T)
Added in v34.0.0
public bool TryParse<T>(CsvTryParser<T> parser, out T value)Tries to parse the value with parser, which gets it as a string and the reader's format provider.
Type parameters
T- The type that
parserparses.
Parameters
parserCsvTryParser<T>- Tries to parse the value with the given format provider.
valueT- The value that
parserproduced.
Returns
bool
The result of
parser: whether the value could be parsed.Exceptions
- ArgumentNullException
parserisnull.