Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Propriedade DataGridViewComboBoxColumn.DisplayMember

Obtém ou define uma seqüência de caracteres que especifica a propriedade ou coluna da qual recuperar seqüências para exibição nas caixas de combinação.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

[TypeConverterAttribute("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string DisplayMember { get; set; }

Valor de propriedade

Tipo: System.String
A String que especifica o nome de uma propriedade ou coluna na fonte de dados especificado na DataSource propriedade. O padrão é String.Empty.

ExceçãoCondição
InvalidOperationException

O valor da CellTemplate propriedade é null.

Os dados para os valores armazenados em uma coluna de DataGridViewComboBoxCell objetos é obtida a partir do DataGridView.DataSource. Se esses dados é proveniente de uma propriedade de não-padrão ou coluna, em seguida, a DisplayMember propriedade deve ser definida como o nome de propriedade necessária ou o nome da coluna.

Se os valores das células não visíveis para o usuário de valores internos, em seguida, use DisplayMember e ValueMember para mapear os valores das células interno para valores visíveis ao usuários.

Quando o DataSource propriedade estiver definida como uma matriz de cadeia de caracteres, o DisplayMember propriedade não precisa ser definido porque cada seqüência de caracteres na matriz será usada como uma seqüência de exibição válido e como um valor válido de subjacente.

Obter ou definir essa propriedade obtém ou define o DisplayMember propriedade do objeto retornado pela CellTemplate propriedade. Configuração desta propriedade também define o DisplayMember a coluna de propriedade de cada célula na coluna e atualizações de exibir. Para substituir o valor especificado para células individuais, defina os valores das células, depois de definir o valor da coluna.

O exemplo de código a seguir demonstra como usar um DataGridViewComboBoxColumn para ajudar na entrada de dados da coluna título. DisplayMember é definido como o nome da propriedade responsável que contém o texto visível ao usuário. Neste exemplo, o DisplayMember é definido como o mesmo valor de ValueMember porque nenhum mapeamento é necessário. Este exemplo é parte de um maior exemplo disponível na DataGridViewComboBoxColumn tópico de visão geral de classe.


private DataGridViewComboBoxColumn CreateComboBoxColumn()
{
    DataGridViewComboBoxColumn column =
        new DataGridViewComboBoxColumn();
    {
        column.DataPropertyName = ColumnName.TitleOfCourtesy.ToString();
        column.HeaderText = ColumnName.TitleOfCourtesy.ToString();
        column.DropDownWidth = 160;
        column.Width = 90;
        column.MaxDropDownItems = 3;
        column.FlatStyle = FlatStyle.Flat;
    }
    return column;
}

private void SetAlternateChoicesUsingDataSource(DataGridViewComboBoxColumn comboboxColumn)
{
    {
        comboboxColumn.DataSource = RetrieveAlternativeTitles();
        comboboxColumn.ValueMember = ColumnName.TitleOfCourtesy.ToString();
        comboboxColumn.DisplayMember = comboboxColumn.ValueMember;
    }
}

private DataTable RetrieveAlternativeTitles()
{
    return Populate("SELECT distinct TitleOfCourtesy FROM Employees");
}

string connectionString =
    "Integrated Security=SSPI;Persist Security Info=False;" +
    "Initial Catalog=Northwind;Data Source=localhost";

private DataTable Populate(string sqlCommand)
{
    SqlConnection northwindConnection = new SqlConnection(connectionString);
    northwindConnection.Open();

    SqlCommand command = new SqlCommand(sqlCommand, northwindConnection);
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.SelectCommand = command;

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);

    return table;
}

// Using an enum provides some abstraction between column index
// and column name along with compile time checking, and gives
// a handy place to store the column names.
enum ColumnName
{
    EmployeeId,
    LastName,
    FirstName,
    Title,
    TitleOfCourtesy,
    BirthDate,
    HireDate,
    Address,
    City,
    Region,
    PostalCode,
    Country,
    HomePhone,
    Extension,
    Photo,
    Notes,
    ReportsTo,
    PhotoPath,
    OutOfOffice
};


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft