Chart.LoadTemplate Method (String)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Loads a template with the specified filename from the disk.

Namespace:   System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)

public void LoadTemplate(
	string name


Type: System.String

The file name of the template to load. You must specify the full path of the template to be loaded from the disk.

The name parameter must use a full path, for example, C:\MyPic.jpg. Note that you must also specify the file extension.

This method loads a template from disk that was saved using the Save method.

Make sure to set the IsTemplateMode property to true before saving the template with the Save method.

If a loaded template has two data series, the appearance properties of the series are applied sequentially to the chart. In other words, the first template series appearance properties are assigned to the first series of the chart, the second template series appearance properties are applied to the second series of the chart, then the first template series is used again for the third series of the chart, and so on. The same holds true for chart areas, and any other collections that have appearance properties.

Templates can be used to simulate custom palettes.

.NET Framework
Available since 4.0
Return to top