syncfusion-aspnetcore-gantt-chart（同步融合 aspnetcore 甘特图）

Syncfusion ASP.NET Core Gantt Chart

The Syncfusion EJ2 Gantt Chart for ASP.NET Core is a powerful project management component that visualizes project schedules, task dependencies, resource allocation, and timelines using Tag Helpers.

When to Use This Skill

Use this skill when you need to:

• Set up and render a Gantt Chart in an ASP.NET Core application
• Bind local or remote data to the Gantt control
• Configure task fields, columns, and the chart timeline
• Enable editing (cell, dialog, taskbar), manage tasks (add/delete/update)
• Define task dependencies (FS, SS, FF, SF) and predecessors
• Assign and display resources on tasks
• Filter, sort, search, or select rows/cells
• Export to Excel or PDF
• Customize the timeline, taskbars, labels, holidays, and event markers
• Configure task scheduling modes (Auto/Manual/Custom)
• Enable undo/redo, state persistence, virtual scrolling, or critical path
• Scroll the component, configure row height, or drag-and-drop rows
• Set timezone or localise the UI for different cultures and RTL languages
• Handle events (actionBegin, actionComplete, cellEdit) or call public methods programmatically

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

• NuGet package installation
• Tag Helper import & CDN setup
• Script manager registration
• First Gantt control (Index.cshtml + Controller)
• Mapping task fields & defining columns
• Enabling editing, filtering, sorting

Data Binding

📄 Read: references/data-binding.md

• Local hierarchical data binding
• Local flat/self-referential data binding
• Remote data (URL Adaptor, OData, Web API)
• Load on demand (lazy loading child records)
• DynamicObject and ExpandoObject binding

Columns

📄 Read: references/columns.md

• Defining columns and field mapping
• Custom column headers & header templates
• Column templates & value accessors
• Checkbox column, frozen columns
• Column reordering, resizing, spanning
• Responsive columns, WBS column, column menu

Managing Tasks (Editing)

📄 Read: references/managing-tasks.md

• IsPrimaryKey requirement for CRUD
• Cell editing, dialog editing, taskbar editing
• Adding and deleting tasks
• Indent / outdent tasks
• Splitting and merging tasks
• Server-side CRUD persistence
• Edit validation and error handling

Task Dependencies

📄 Read: references/task-dependency.md

• SS, SF, FS, FF relationship types
• Mapping dependency field
• Predecessor offset values
• Dependency editing via mouse drag
• Validation, error handling, parent dependencies

Resources

📄 Read: references/resources.md

• Resource collection and field mapping
• Assigning resources to tasks
• Resource view mode
• Multi-taskbar display
• Resource customization

Filtering

📄 Read: references/filtering.md

• Menu filtering (column-level)
• Excel-like filtering
• Toolbar search / searching
• Filter settings and programmatic filtering

Sorting

📄 Read: references/sorting.md

• Enabling sorting, multi-column sort
• Initial sort configuration
• Programmatic sort / clear sort

Timeline

📄 Read: references/timeline.md

• Top tier and bottom tier configuration
• Zooming in and out
• Custom timeline units and formats
• Timeline template

Task Scheduling

📄 Read: references/task-scheduling.md

• Auto, Manual, Custom scheduling modes
• Duration units (day, hour, minute, week, month)
• Unscheduled tasks
• Task constraints (ALAP, ASAP, FNLT, SNLT, MSO, MFO)
• Baseline display

Selection

📄 Read: references/selection.md

• Row selection and cell selection
• Single/multiple selection modes
• Programmatic selection

Scrolling

📄 Read: references/scrolling.md

• Configure component height and width to enable scrollbars
• Responsive sizing with 100% and parent container height requirements
• Programmatic timeline scroll via scrollToDate()
• Set vertical scroll with ganttObj.ganttChartModule.scrollObject.setScrollTop()

Rows

📄 Read: references/rows.md

• Configure global rowHeight and per-row expand state via taskFields.expandState
• Collapse all parent tasks at load with collapseAllParentTasks
• Customize row appearance with rowDataBound and queryTaskbarInfo
• Row spanning via queryCellInfo.rowSpan and clip modes for overflow

Row Drag And Drop

📄 Read: references/row-drag-and-drop.md

• Enable row reordering with allowRowDragAndDrop and selectionSettings.type = "Multiple" for multi-drag
• Allow taskbar-based drag with allowTaskbarDragAndDrop and edit mode Auto
• Lifecycle events: rowDragStartHelper, rowDragStart, rowDrag, rowDrop
• Programmatic reordering via reorderRows(fromIndexes, toIndex, position)

Timezone

📄 Read: references/timezone.md

• Set timezone (e.g., UTC, America/New_York) to normalise displayed dates across clients
• CRUD operations respect configured timezone and convert for server persistence
• Utility methods: ej.schedule.Timezone().offset(), convert(), and remove() for programmatic conversions

Globalization

📄 Read: references/globalization.md

• Localize UI text via locale and ej.base.L10n.load() translation objects
• Internationalization: load CLDR files to format dates and numbers per culture
• Enable RTL layout with enableRtl="true" for right-to-left languages

Export (Excel & PDF)

📄 Read: references/export.md

• Excel export with column and data customization
• PDF export with themes and custom columns
• Exporting multiple Gantt charts to a single PDF

Toolbar

📄 Read: references/toolbar.md

• Built-in toolbar items (Add, Edit, Delete, Search, ExpandAll, CollapseAll, ExcelExport, PdfExport, ZoomIn, ZoomOut, ZoomToFit, UndoRedo)
• Custom toolbar items and click handling
• Enabling/disabling toolbar items programmatically

Context Menu

📄 Read: references/context-menu.md

• Enable context menu with enableContextMenu="true"
• Built-in context menu items for CRUD operations
• Custom context menu items and click event handling

Taskbar

📄 Read: references/taskbar.md

• Taskbar height, custom templates, milestone appearance
• Progress bar customization and connector line configuration
• Segment taskbars (split tasks) rendering

Labels and Tooltips

📄 Read: references/labels-and-tooltips.md

• Left/right/inside label templates on taskbars
• Taskbar tooltip customization via tooltipSettings
• Connector line and baseline tooltips

Event Markers

📄 Read: references/event-markers.md

• Add striplines/event markers with <e-gantt-eventmarkers>
• Custom label and CSS class per marker
• Dynamic event markers

Critical Path

📄 Read: references/critical-path.md

• Enable critical path highlighting with enableCriticalPath="true"
• Critical path rendering and customization
• Critical slack value configuration

Splitter

📄 Read: references/splitter.md

• Configure grid/chart pane ratio with splitterSettings
• Set splitter position by column index, percentage, or pixel
• Programmatic splitter position update via setSplitterPosition()

Undo and Redo

📄 Read: references/undo-redo.md

• Enable undo/redo via toolbar items or Ctrl+Z / Ctrl+Y
• Configure undo-redo history size (undoRedoStepsCount)
• Supported actions and programmatic undo() / redo() calls

State Persistence

📄 Read: references/state-persistence.md

• Enable persistence with enablePersistence="true" (saves to localStorage)
• Persisted properties: filter, sort, column width, scroll position, zoom level
• Clearing persisted state programmatically

Immutable Mode

📄 Read: references/immutable-mode.md

• Enable enableImmutableMode="true" to prevent re-render of unchanged rows
• Performance benefit for large data sets with frequent updates
• Limitations and usage patterns

Virtual Scroll

📄 Read: references/virtual-scroll.md

• Enable row virtualization with enableVirtualization="true"
• Enable timeline virtualization with enableTimelineVirtualization="true"
• Performance characteristics and known limitations

Loading Animation

📄 Read: references/loading-animation.md

• Built-in spinner shown during data load
• Show/hide loading indicator programmatically via showSpinner() / hideSpinner()
• Custom loading template

Style and Appearance

📄 Read: references/style-and-appearance.md

• Applying Syncfusion themes (Bootstrap, Material, Fabric, High Contrast)
• CSS class overrides for taskbars, grid rows, and header
• queryTaskbarInfo event for per-task styling

Events

📄 Read: references/events.md

• Wire events via camelCase Tag Helper attributes (actionBegin, actionComplete, actionFailure)
• actionBegin — cancel-able hook before every CRUD, filter, sort, zoom, and dependency action
• actionComplete — post-action callback with requestType reference table
• cellEdit — prevent specific cells or rows from entering edit mode
• beforeTooltipRender — customise or suppress any tooltip dynamically
• Row/cell selection events: rowSelecting, rowSelected, rowDeselecting, rowDeselected, cellSelecting, cellSelected
• Export events: beforeExcelExport, beforePdfExport, excelExportComplete, pdfExportComplete

Public Methods

📄 Read: references/methods.md

• Data access: getCurrentViewData(), getRecordByID(), getTaskByUniqueID(), getRowByID()
• Row expand/collapse: expandAll(), collapseAll(), expandByID(), collapseByID(), expandByIndex()
• Task utilities: changeTaskMode(), convertToMilestone(), updateTaskId(), updateDataSource()
• Scrolling: scrollToDate(), scrollToTask(), setScrollTop(), updateChartScrollOffset()
• Search: search(keyword) — programmatic search across displayed columns
• Lifecycle: refresh(), dataBind(), getRootElement(), addEventListener(), removeEventListener()
• Module injection reference table (ej.gantt.Filter, Edit, RowDD, CriticalPath, etc.)

Quick Start Example

@* ~/Pages/Index.cshtml *@
<ejs-gantt id="Gantt"
           dataSource="ViewBag.DataSource"
           height="450px">
    <e-gantt-taskfields id="TaskId"
                        name="TaskName"
                        startDate="StartDate"
                        endDate="EndDate"
                        duration="Duration"
                        progress="Progress"
                        child="SubTasks">
    </e-gantt-taskfields>
</ejs-gantt>

// HomeController.cs
public IActionResult Index()
{
    ViewBag.DataSource = GanttData.ProjectNewData();
    return View();
}

Common Patterns

Enable Editing

<ejs-gantt id="Gantt" dataSource="ViewBag.DataSource" height="450px">
    <e-gantt-taskfields id="TaskId" name="TaskName" startDate="StartDate"
                        endDate="EndDate" duration="Duration" progress="Progress"
                        child="SubTasks">
    </e-gantt-taskfields>
    <e-gantt-editsettings allowEditing="true" allowAdding="true"
                          allowDeleting="true" allowTaskbarEditing="true"
                          mode="Auto">
    </e-gantt-editsettings>
    <e-gantt-columns>
        <e-gantt-column field="TaskId" isPrimaryKey="true"></e-gantt-column>
        <e-gantt-column field="TaskName"></e-gantt-column>
    </e-gantt-columns>
</ejs-gantt>

Enable Filtering and Sorting

<ejs-gantt id="Gantt" dataSource="ViewBag.DataSource"
           allowFiltering="true" allowSorting="true" height="450px">
    <e-gantt-taskfields id="TaskId" name="TaskName" startDate="StartDate"
                        endDate="EndDate" duration="Duration" progress="Progress"
                        child="SubTasks">
    </e-gantt-taskfields>
</ejs-gantt>

Toolbar with Export

<ejs-gantt id="Gantt" dataSource="ViewBag.DataSource"
           toolbar="@(new List<string>() { "Add","Edit","Delete","Cancel","Update","ExpandAll","CollapseAll","ExcelExport","PdfExport" })"
           allowExcelExport="true" allowPdfExport="true" height="450px">
    <e-gantt-taskfields id="TaskId" name="TaskName" startDate="StartDate"
                        endDate="EndDate" duration="Duration" child="SubTasks">
    </e-gantt-taskfields>
</ejs-gantt>