DataGrid.AutoGenerateColumns Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se as colunas são criadas automaticamente.
public:
property bool AutoGenerateColumns { bool get(); void set(bool value); };
public bool AutoGenerateColumns { get; set; }
member this.AutoGenerateColumns : bool with get, set
Public Property AutoGenerateColumns As Boolean
Valor da propriedade
true
se as colunas forem criadas automaticamente, caso contrário, false
. O padrão registrado é true
. Para obter mais informações sobre o que pode influenciar o valor, consulte DependencyProperty.
Exemplos
O exemplo a seguir mostra como gerar colunas automaticamente e alterar as colunas no momento da criação no AutoGeneratingColumn manipulador de eventos.
<!-- The DataGrid.DataContext is a DataTable that contains a list of customers. The DataTable columns are
Title, FirstName, MiddleName, LastName, Suffix, CompanyName, EmailAddress, and Phone.-->
<DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="True" AutoGeneratingColumn="DG1_AutoGeneratingColumn" />
//Access and update columns during autogeneration
private void DG1_AutoGeneratingColumn(object sender, DataGridAutoGeneratingColumnEventArgs e)
{
string headername = e.Column.Header.ToString();
//Cancel the column you don't want to generate
if (headername == "MiddleName")
{
e.Cancel = true;
}
//update column details when generating
if (headername == "FirstName")
{
e.Column.Header = "First Name";
}
else if (headername == "LastName")
{
e.Column.Header = "Last Name";
}
else if (headername == "EmailAddress")
{
e.Column.Header = "Email";
}
}
'Access and update columns during autogeneration
Private Sub DG1_AutoGeneratingColumn(ByVal sender As Object, ByVal e As DataGridAutoGeneratingColumnEventArgs)
Dim headername As String = e.Column.Header.ToString()
'Cancel the column you don't want to generate
If headername = "MiddleName" Then
e.Cancel = True
End If
'update column details when generating
If headername = "FirstName" Then
e.Column.Header = "First Name"
ElseIf headername = "LastName" Then
e.Column.Header = "Last Name"
ElseIf headername = "EmailAddress" Then
e.Column.Header = "Email"
End If
End Sub
Comentários
Definir AutoGenerateColumns como true
ou false
cria ou remove colunas geradas automaticamente. Quando a AutoGenerateColumns propriedade for definida true
como , o AutoGeneratingColumn evento será gerado para cada coluna criada. Você pode alterar ou cancelar a coluna que está sendo criada no AutoGeneratingColumn manipulador de eventos.
Quando a geração automática de todas as colunas é concluída, o AutoGeneratedColumns evento é gerado.
Observação
DataGrid não é possível gerar colunas automaticamente quando a origem é dados XML. Nesse caso, crie uma coleção personalizada Columns . Para ver um exemplo, consulte DataGridTextColumn.