CSF.Zpt.Tales.TemplateDirectory Class Reference

Implementation of FilesystemDirectory which contains template objects. More...

Inheritance diagram for CSF.Zpt.Tales.TemplateDirectory:

Collaboration diagram for CSF.Zpt.Tales.TemplateDirectory:

Public Member Functions
override bool	HandleTalesPath (string pathFragment, out object result, Rendering.IRenderingContext currentContext)
	Gets an System.Object based upon a TALES path fragment. More...
	TemplateDirectory (DirectoryInfo directory, bool mandatoryExtensions=false)
	Initializes a new instance of the CSF.Zpt.Tales.TemplateDirectory class. More...
Public Member Functions inherited from CSF.Zpt.Tales.FilesystemDirectory
	FilesystemDirectory (DirectoryInfo directory, bool mandatoryExtensions=false)
	Initializes a new instance of the CSF.Zpt.Tales.FilesystemDirectory class. More...
Public Member Functions inherited from CSF.Zpt.Tales.ITalesPathHandler
bool	HandleTalesPath (string pathFragment, out object result, IRenderingContext currentContext)
	Gets an System.Object based upon a TALES path fragment. More...

Protected Member Functions
override FilesystemDirectory	CreateChild (DirectoryInfo directory)
	Creates a child instance of FilesystemDirectory for the given subdirectory. More...

Additional Inherited Members
Properties inherited from CSF.Zpt.Tales.FilesystemDirectory
bool	MandatoryExtensions [get]
	Gets a value indicating whether or not filename extensions are mandatory or not. More...
DirectoryInfo	DirectoryInfo [get]
	Gets the DirectoryInfo associated with the current instance. More...

Detailed Description

Implementation of FilesystemDirectory which contains template objects.

Constructor & Destructor Documentation

CSF.Zpt.Tales.TemplateDirectory.TemplateDirectory ( DirectoryInfo  directory, bool  mandatoryExtensions = false  )

inline

Initializes a new instance of the CSF.Zpt.Tales.TemplateDirectory class.

Parameters

directory	Directory.
mandatoryExtensions	If set to true mandatory extensions.

Member Function Documentation

override FilesystemDirectory CSF.Zpt.Tales.TemplateDirectory.CreateChild ( DirectoryInfo  directory )

inlineprotectedvirtual

Creates a child instance of FilesystemDirectory for the given subdirectory.

Returns

The child instance.

Parameters

directory

Directory.

Reimplemented from CSF.Zpt.Tales.FilesystemDirectory.

override bool CSF.Zpt.Tales.TemplateDirectory.HandleTalesPath ( string  pathFragment, out object  result, Rendering.IRenderingContext  currentContext  )

inlinevirtual

Gets an System.Object based upon a TALES path fragment.

This method should return a System.Object which represents the traversal of a single-level TALES path fragment, from the current instance. The value of that fragment is passed via the name pathFragment .

The precise meaning of 'traversal' is left to the implementation, but typical semantics will see an object return an associated object from an object graph.

In this simple example, the Employee class may return data from a related Person object, without exposing the Person object directly. This might be because (as shown in this example), the API of that Person object is more complex than desired, and so TALES should see a simplified version.

public class Employee : ITalesPathHandler
{
  private Person _person;

  public bool HandleTalesPath(string pathFragment, out object result, RenderingContext currentContext)
  {
    switch(pathFragment)
    {
    case: "name";
      result = _person.Name;
      return true;
    case: "address";
      result = _person.Address.FullAddress;
      return true;
    case: "gender":
      result = _person.Gender.ToString();
      return true;
    default:
      result = null;
      return false;
    }
  }
}

Note that the return value does not need to be a primitive type. It may be a complex object, and the return value may also implement ITalesPathHandler if desired.

Returns

true if the path traversal was a success; false otherwise.

Parameters

pathFragment	The path fragment.
result	Exposes the result if the traversal was a success
currentContext	Gets the current rendering context.

Reimplemented from CSF.Zpt.Tales.FilesystemDirectory.

---

The documentation for this class was generated from the following file:

• /home/craig/Projects/CSF.Zpt/CSF.Zpt/Tales/TemplateDirectory.cs