DataGridColumnStyle.MappingName プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridColumnStyle.MappingName プロパティ

列スタイルの割り当て先のデータ メンバの名前を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property MappingName As
 String

Visual Basic (使用法)

Dim instance As DataGridColumnStyle
Dim value As String

value = instance.MappingName

instance.MappingName = value

C#

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

C++

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

J#

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

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

JScript

public function get MappingName
 () : String

public function set MappingName
 (value : String)

プロパティ値
列スタイルの割り当て先のデータ メンバの名前。

解説

MappingName をデータ メンバと突き合わせるための比較では、大文字と小文字が区別されません。

この列スタイルを格納する DataGridTableStyle の MappingName プロパティにより指定されたデータ メンバとデータ ソースが一致した場合、この DataGridColumnStyle を使用して、指定されたデータ メンバのデータを描画します。

通常、DataGridColumnStyle.MappingName プロパティは、DataColumn の ColumnName に設定されます。

使用例

DataGridTableStyle を作成し、2 つの DataGridColumnStyle オブジェクトを GridColumnStylesCollection に追加するコード例を次に示します。各 DataGridColumnStyle オブジェクトの MappingName は、DataColumn の ColumnName に設定されます。

Visual Basic

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

C#

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);
}

C++

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 );
}

J#

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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataGridColumnStyle クラス
DataGridColumnStyle メンバ
System.Windows.Forms 名前空間