Run Time Record Class Examples

From the version 1.6.0 you can use the new RuntimeRecords, this was one of the most requested features and the most fun to write because I need a clear API and that can be expended in the future other adds (XML backends, easy CSV records, etc).

I hope that you like the way that I use to implement them and ofcourse that any suggestion is welcome.

The most importat is that you have a lot of ways to create or load your record class at runtime:

• The best of all: using the ClassBuilder !!
• From an XML file generated with the Wizard or saved with the SaveXml method of the ClassBuilder
• From a string with the source of the class
• From a file with the source of the class
• From a encripted file with the source of the class
• From a assebly loaded at runtime that contains the class (next version)

And now some examples of the basic methods:

Note: Your need to import the namespace FileHelpers.RunTime

Using the CodeBuilder (FixedLength)

FixedClassBuilder cb = new FixedLengthClassBuilder("Customers"); cb.AddField("BirthDate", 8, typeof(DateTime)); cb.LastField.Converter.Kind = ConverterKind.Date; cb.LastField.Converter.Arg1 = "ddMMyyyy"; cb.LastField.FieldNullValue = DateTime.Now; cb.AddField("Name", 3, typeof(string)); cb.AddField("Age", 3, typeof(int)); cb.LastField.TrimMode = TrimMode.Both; engine = new FileHelperEngine(cb.CreateRecordClass()); DataTable dt = engine.ReadFileAsDT("testCustomers.txt");

Using the CodeBuilder (Delimited)

DelimitedClassBuilder cb = new DelimitedClassBuilder("Customers", ","); cb.IgnoreFirstLines = 1; cb.IgnoreEmptyLines = true; cb.AddField("BirthDate", typeof(DateTime)); cb.LastField.TrimMode = TrimMode.Both; cb.LastField.FieldNullValue = DateTime.Today; cb.AddField("Name", typeof(string)); cb.LastField.FieldQuoted = true; cb.LastField.QuoteChar = '"'; cb.AddField("Age", typeof(int)); engine = new FileHelperEngine(cb.CreateRecordClass()); DataTable dt = engine.ReadFileAsDT("testCustomers.txt");

Form an Xml File generated with the Wizard or saved from a ClassBuilder

ClassBuilder cd = ClassBuilder.LoadXml("Customers.fhw"); engine = new FileHelperEngine(cb.CreateRecordClass()); // Or engine = new FileHelperEngine(ClassBuilder.ClassFromXmlFile("Customers.fhw")); // Use it DataTable dt = engine.ReadFileAsDT("customers.txt");

Form a string with the source of the record class.

// The class definition public string mClass = @" [DelimitedRecord("|")] public class SampleType { [FieldConverter(ConverterKind.Date, ""ddMMyyyy"")] public DateTime Field1; public string Field2; public int Field3; } "; Type t = ClassBuilder.ClassFromString(mClass); FileHelperEngine engine = new FileHelperEngine(t); DataTable = engine.ReadFileAsDT("test.txt");

Form a file with the source of the record class.

Type t = ClassBuilder.ClassFromFile("your_class.cs"); FileHelperEngine engine = new FileHelperEngine(t); DataTable = engine.ReadFileAsDT("test.txt");

Form a encripted source file of the record class.

The idea of the encripted file is not security (you can found the keyphrase in the code)
This only aims to hide to end users part of your code and so they don't touch it =) // .fhc estands for File Helper Class Type t = ClassBuilder.ClassFromBinaryFile("your_class.fhc"); FileHelperEngine engine = new FileHelperEngine(t); DataTable = engine.ReadFileAsDT("test.txt");

See also

Must Read - Quick Start Guide - Attributes List - F.A.Q. - Examples of Use - Contacts & Credits - Donations

---

© 2005-07 to Marcos Meli FileHelpers on SourceForge