The star sizing mode is used to distribute available space by weighted proportions. The pixel-based sizing mode sizes DataGrid columns based on the numeric value provided. The header-based automatic sizing mode sizes DataGrid columns based on the contents of column headers only. The cell-based automatic sizing mode sizes DataGrid columns based on the contents of cells in the column, not including column headers. The default automatic sizing mode sizes DataGrid columns based on the contents of both cells and column headers. The following table shows the values provided by the DataGridLengthUnitType structure. The DataGrid uses values of the DataGridLength and the DataGridLengthUnitType structure to specify absolute or automatic sizing modes. Sizing Columns and Column Headers DataGrid Columns The row headers can be given a specific width by setting the DataGrid.RowHeaderWidth property. By default, when row headers are displayed, they automatically size to fit their content. To display row headers, the HeadersVisibility property must be set to DataGridHeadersVisibility.Row or DataGridHeadersVisibility.All and the DataGrid's ControlTemplate should be altered to provide a visual for the RowHeader as desired. DataGrid Row Headersīy default, DataGrid row headers are not displayed. Users cannot change the row height by dragging the row header dividers. The height of all rows in the DataGrid can be specified by setting the DataGrid.RowHeight property. Sizing Rows and Row Headers DataGrid Rowsīy default, a DataGrid row's Height property is set to Double.NaN ('Auto' in XAML), and the row height will expand to the size of its contents. The DataGrid will shrink horizontally until it reaches this width. Sets the lower bound for the width of the DataGrid.

The DataGrid will grow horizontally until it reaches this width. Sets the upper bound for the width of the DataGrid. The DataGrid will shrink vertically until it reaches this height. Sets the lower bound for the height of the DataGrid. The DataGrid will grow vertically until it reaches this height. Sets the upper bound for the height of the DataGrid. The following table shows the properties that can be set to control the DataGrid size.

The DataGrid can be set to automatically size within specified boundaries, or the DataGrid can be set to a specific size. When the Height is restricted, the DataGrid will only create the rows that will fit within its specified Height, and will recycle those rows as needed to display new data. To avoid these issues when you work with large data sets, it is recommended that you specifically set the Height of the DataGrid or place it in a container that will restrict its Height, such as a Grid or RelativePanel. If you are working with a large data set and you allow the DataGrid to automatically size itself, the creation of a large number of objects may affect the performance of your application. The DataGrid will not show scrollbars in this case because its Height will continue to grow to accommodate the new rows.Īn object is created for each row in the DataGrid. This can cause the DataGrid to grow outside the visible bounds of your application as rows are added. When bound to a data set, if the Height of the DataGrid is not restricted, it will continue to add a row for each data item in the bound data set. This condition has both usability and performance implications. When placed inside a container that does not restrict the size of its children, such as a StackPanel, the DataGrid, like ListView and other scrollable controls, will stretch beyond the visible bounds of the container and scrollbars will not be shown. Sizing the DataGrid Cautions When Using Automatic Sizingīy default, the Height and Width properties of the DataGrid are set to Double.NaN ('Auto' in XAML), and the DataGrid will adjust to the size of its contents.

By default, the DataGrid will grow and shrink to fit the size of its contents. The DataGrid, and individual rows and columns in the DataGrid, can be set to size automatically to their contents or can be set to specific values. Various options are available to control how the DataGrid sizes itself.

Datagrip logo