DataGridColumnStyle.MappingName-Eigenschaft

Ruft den Namen des Datenmembers fest, dem das Spaltenformat zugeordnet werden soll, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property MappingName As String
'Usage
Dim instance As DataGridColumnStyle
Dim value As String

value = instance.MappingName

instance.MappingName = value

[LocalizableAttribute(true)] 
public string MappingName { get; set; }

[LocalizableAttribute(true)] 
public:
property String^ MappingName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_MappingName ()

/** @property */
public void set_MappingName (String value)

public function get MappingName () : String

public function set MappingName (value : String)

Eigenschaftenwert

Der Name des Datenmembers, dem das Spaltenformat zugeordnet werden soll.

Hinweise

Bei dem Vergleichsvorgang, der für das Zuordnen des MappingName zum Datenmember durchgeführt wird, wird die Groß-/Kleinschreibung nicht berücksichtigt.

Dieser DataGridColumnStyle wird immer dann zum Darstellen der Daten im angegebenen Datenmember verwendet, wenn die Datenquelle mit der Datenquelle übereinstimmt, die von der MappingName-Eigenschaft des DataGridTableStyle angegeben wird, der dieses Spaltenformat enthält.

Die DataGridColumnStyle.MappingName-Eigenschaft wird i. d. R. auf den ColumnName einer DataColumn festgelegt.

Beispiel

Im folgenden Codebeispiel wird ein DataGridTableStyle erstellt, und dem DataGridColumnStyle werden zwei GridColumnStylesCollection-Objekte hinzugefügt. Der MappingName jedes DataGridColumnStyle wird auf den ColumnName einer DataColumn festgelegt.

Private Sub AddDataGridTableStyle()
   ' Create a new DataGridTableStyle and set MappingName.
   Dim myGridStyle As DataGridTableStyle = _
   new DataGridTableStyle()
   myGridStyle.MappingName = "Customers"

   ' Add two DataGridColumnStyle objects.
   Dim colStyle1 As DataGridColumnStyle = _
   new DataGridTextBoxColumn()
   colStyle1.MappingName = "firstName"
   
   Dim colStyle2 As DataGridColumnStyle = _
   new DataGridBoolColumn()
   colStyle2.MappingName = "Current"

   ' Add column styles to table style.
   myGridStyle.GridColumnStyles.Add(colStyle1)
   myGridStyle.GridColumnStyles.Add(colStyle2)   

   ' Add the grid style to the GridStylesCollection.
   myDataGrid.TableStyles.Add(myGridStyle)
End Sub

private void AddDataGridTableStyle()
{
   // Create a new DataGridTableStyle and set MappingName.
   DataGridTableStyle myGridStyle = 
   new DataGridTableStyle();
   myGridStyle.MappingName = "Customers";

   // Create two DataGridColumnStyle objects.
   DataGridColumnStyle colStyle1 =
   new DataGridTextBoxColumn();
   colStyle1.MappingName = "firstName";
   
   DataGridColumnStyle colStyle2 =
   new DataGridBoolColumn();
   colStyle2.MappingName = "Current";

   // Add column styles to table style.
   myGridStyle.GridColumnStyles.Add(colStyle1);
   myGridStyle.GridColumnStyles.Add(colStyle2);   

   // Add the grid style to the GridStylesCollection.
   myDataGrid.TableStyles.Add(myGridStyle);
}

void AddDataGridTableStyle()
{
   // Create a new DataGridTableStyle and set MappingName.
   DataGridTableStyle^ myGridStyle = gcnew DataGridTableStyle;
   myGridStyle->MappingName = "Customers";
   
   // Create two DataGridColumnStyle objects.
   DataGridColumnStyle^ colStyle1 = gcnew DataGridTextBoxColumn;
   colStyle1->MappingName = "firstName";
   DataGridColumnStyle^ colStyle2 = gcnew DataGridBoolColumn;
   colStyle2->MappingName = "Current";
   
   // Add column styles to table style.
   myGridStyle->GridColumnStyles->Add( colStyle1 );
   myGridStyle->GridColumnStyles->Add( colStyle2 );
   
   // Add the grid style to the GridStylesCollection.
   myDataGrid->TableStyles->Add( myGridStyle );
}

private void AddDataGridTableStyle()
{
    // Create a new DataGridTableStyle and set MappingName.
    DataGridTableStyle myGridStyle = new DataGridTableStyle();
    myGridStyle.set_MappingName("Customers");

    // Create two DataGridColumnStyle objects.
    DataGridColumnStyle colStyle1 = new DataGridTextBoxColumn();
    colStyle1.set_MappingName("firstName");

    DataGridColumnStyle colStyle2 = new DataGridBoolColumn();
    colStyle2.set_MappingName("Current");

    // Add column styles to table style.
    myGridStyle.get_GridColumnStyles().Add(colStyle1);
    myGridStyle.get_GridColumnStyles().Add(colStyle2);

    // Add the grid style to the GridStylesCollection.
    myDataGrid.get_TableStyles().Add(myGridStyle);
} //AddDataGridTableStyle

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataGridColumnStyle-Klasse
DataGridColumnStyle-Member
System.Windows.Forms-Namespace