DataGridTableStyle.AllowSorting プロパティ

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

DataGridTableStyle.AllowSorting プロパティ

DataGridTableStyle を使用する場合に、グリッド テーブルで並べ替えを実行できるかどうかを示します。

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

Visual Basic (宣言)

Public Property AllowSorting As
 Boolean

Visual Basic (使用法)

Dim instance As DataGridTableStyle
Dim value As Boolean

value = instance.AllowSorting

instance.AllowSorting = value

C#

public bool AllowSorting { get;
 set; }

C++

public:
property bool AllowSorting {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_AllowSorting ()

/** @property */
public void set_AllowSorting (boolean value)

JScript

public function get AllowSorting
 () : boolean

public function set AllowSorting
 (value : boolean)

プロパティ値
並べ替えを実行できる場合は true。それ以外の場合は false。既定値は true です。

解説

AllowSorting プロパテイが true に設定されている場合、各列ヘッダーに並べ替えの方向を示す三角形が表示されます。いずれかの列ヘッダーをクリックすると、その列を基準としてグリッドを並べ替えることができます。同じ列をもう一度クリックすると、並べ替えの方向が変わります。

このプロパティは、DataGrid.AllowSorting プロパティをオーバーライドします。

使用例

ボタンをクリックすることによって DataGrid 上で並べ替えを実行できるようにし、現在の並べ替えの状態をラベルに表示するコード例を次に示します。この例は、データを格納する System.Data.DataSet を持つ DataGrid、Button、および Label が、Form 上にあることを前提としています。

Visual Basic

Private Sub DataGridTableStyle_Sample_Load(ByVal
 sender As Object, _
                        ByVal e As EventArgs)
 Handles MyBase.Load
   myDataGridTableStyle1 = New DataGridTableStyle()

   mylabel.Text = "Sorting Status :" + myDataGridTableStyle1.AllowSorting.ToString()
   If myDataGridTableStyle1.AllowSorting = True
 Then
      btnApplyStyles.Text = "Remove Sorting"
   Else
      btnApplyStyles.Text = "Apply Sorting"
   End If
   ' Attach custom event handlers.
   AddHandler myDataGridTableStyle1.AllowSortingChanged, AddressOf
 AllowSortingChanged_Handler
   myDataGridTableStyle1.MappingName = "Customers"
End Sub 'DataGridTableStyle_Sample_Load

Private Sub AllowSortingChanged_Handler(ByVal
 sender As Object, ByVal
 e As EventArgs)
   mylabel.Text = "Sorting Status :" + myDataGridTableStyle1.AllowSorting.ToString()
End Sub 'AllowSortingChanged_Handler

Private Sub btnApplyStyles_Click(ByVal
 sender As Object, _
                                 ByVal e As
 EventArgs) Handles btnApplyStyles.Click
   If myDataGridTableStyle1.AllowSorting = True
 Then
      ' Remove sorting.
      myDataGridTableStyle1.AllowSorting = False
      btnApplyStyles.Text = "Allow Sorting"
   Else
      ' Allow sorting.
      myDataGridTableStyle1.AllowSorting = True
      btnApplyStyles.Text = "Remove Sorting"
   End If

   mylabel.Text = "Sorting Status :" + myDataGridTableStyle1.AllowSorting.ToString
   ' Add the DataGridTableStyle to DataGrid.
   myDataGrid.TableStyles.Add(myDataGridTableStyle1)
End Sub 'btnApplyStyles_Click

C#

private void DataGridTableStyle_Sample_Load(object
 sender,
                                       EventArgs e)
{
   myDataGridTableStyle1 = new DataGridTableStyle();

   mylabel.Text = "Sorting Status :" + 
         myDataGridTableStyle1.AllowSorting.ToString();
   if(myDataGridTableStyle1.AllowSorting == true)
   {
      btnApplyStyles.Text = "Remove Sorting";
   }
   else
   {
      btnApplyStyles.Text = "Apply Sorting";
   }
   // Attach custom event handlers.
   myDataGridTableStyle1.AllowSortingChanged += 
               new System.EventHandler(AllowSortingChanged_Handler);
   myDataGridTableStyle1.MappingName = "Customers";
} 
private void AllowSortingChanged_Handler(object
 sender,EventArgs e)
{         
   mylabel.Text = "Sorting Status :" 
         + myDataGridTableStyle1.AllowSorting.ToString();
}     
private void btnApplyStyles_Click(object sender,
 EventArgs e)
{       

   if(myDataGridTableStyle1.AllowSorting == true)
   {            
      // Remove sorting.
      myDataGridTableStyle1.AllowSorting = false; 
      btnApplyStyles.Text = "Allow Sorting";
   }
   else
   {
      // Allow sorting.
      myDataGridTableStyle1.AllowSorting = true;
      btnApplyStyles.Text = "Remove Sorting";
   } 

   mylabel.Text = "Sorting Status :" + myDataGridTableStyle1.AllowSorting;
   // Add the DataGridTableStyle to DataGrid.
   myDataGrid.TableStyles.Add(myDataGridTableStyle1);
}

C++

private:
   void DataGridTableStyle_Sample_Load( Object^ /*sender*/, EventArgs^
 /*e*/ )
   {
      myDataGridTableStyle1 = gcnew DataGridTableStyle;
      mylabel->Text = String::Concat( "Sorting Status : ", myDataGridTableStyle1->AllowSorting
 );
      if ( myDataGridTableStyle1->AllowSorting == true
 )
      {
         btnApplyStyles->Text = "Remove Sorting";
      }
      else
      {
         btnApplyStyles->Text = "Apply Sorting";
      }

      myDataGridTableStyle1->AllowSortingChanged += gcnew System::EventHandler(
         this, &DataGridTableStyle_Sample::AllowSortingChanged_Handler
 );
      myDataGridTableStyle1->MappingName = "Customers";
   }

   void AllowSortingChanged_Handler( Object^ /*sender*/, EventArgs^
 /*e*/ )
   {
      mylabel->Text = String::Concat( "Sorting Status : ", myDataGridTableStyle1->AllowSorting
 );
   }

   void btnApplyStyles_Click( Object^ /*sender*/, EventArgs^ /*e*/
 )
   {
      if ( myDataGridTableStyle1->AllowSorting == true
 )
      {
         // Remove sorting.
         myDataGridTableStyle1->AllowSorting = false;
         btnApplyStyles->Text = "Allow Sorting";
      }
      else
      {
         // Allow sorting.
         myDataGridTableStyle1->AllowSorting = true;
         btnApplyStyles->Text = "Remove Sorting";
      }

      mylabel->Text = String::Concat( "Sorting Status : ", myDataGridTableStyle1->AllowSorting
 );

      // Add the DataGridTableStyle to DataGrid.
      myDataGrid->TableStyles->Add( myDataGridTableStyle1 );
   }

J#

private void DataGridTableStyleSampleLoad(Object
 sender, EventArgs e)
{
    myDataGridTableStyle1 = new DataGridTableStyle();
    mylabel.set_Text("Sorting Status :" 
        + System.Convert.ToString(myDataGridTableStyle1.get_AllowSorting()));
    if (myDataGridTableStyle1.get_AllowSorting() == true)
 {
        btnApplyStyles.set_Text("Remove Sorting");
    }
    else {
        btnApplyStyles.set_Text("Apply Sorting");
    }

    // Attach custom event handlers.
    myDataGridTableStyle1.add_AllowSortingChanged(
        new System.EventHandler(AllowSortingChanged_Handler));
    myDataGridTableStyle1.set_MappingName("Customers");
} //DataGridTableStyleSampleLoad

private void AllowSortingChanged_Handler(Object
 sender, EventArgs e)
{
    mylabel.set_Text("Sorting Status :" 
        + System.Convert.ToString(myDataGridTableStyle1.get_AllowSorting()));
} //AllowSortingChanged_Handler

private void btnApplyStyles_Click(Object sender,
 EventArgs e)
{
    if (myDataGridTableStyle1.get_AllowSorting() == true)
 {
        // Remove sorting.
        myDataGridTableStyle1.set_AllowSorting(false);
        btnApplyStyles.set_Text("Allow Sorting");
    }
    else {
        // Allow sorting.
        myDataGridTableStyle1.set_AllowSorting(true);
        btnApplyStyles.set_Text("Remove Sorting");
    }
    mylabel.set_Text("Sorting Status :" 
        + ((myDataGridTableStyle1.get_AllowSorting()) ? "True" : "False"));
    // Add the DataGridTableStyle to DataGrid.
    myDataGrid.get_TableStyles().Add(myDataGridTableStyle1);
} //btnApplyStyles_Click

プラットフォーム

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

参照

関連項目
DataGridTableStyle クラス
DataGridTableStyle メンバ
System.Windows.Forms 名前空間
AllowSortingChanged
DataGrid.AllowSorting プロパティ