DataGridTextBoxColumn.Format プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DataGridTextBoxColumn.Format プロパティ

テキストの書式指定方法を指定する 1 文字以上の文字を取得または設定します。

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

Visual Basic (宣言)

Public Property Format As
 String

Visual Basic (使用法)

Dim instance As DataGridTextBoxColumn
Dim value As String

value = instance.Format

instance.Format = value

public string Format { get;
 set; }

C++

public:
property String^ Format {
    String^ get ();
    void set (String^ value);
}

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

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

JScript

public function get Format
 () : String

public function set Format
 (value : String)

プロパティ値
テキストの書式指定方法を指定する 1 文字以上の文字。

解説

Format プロパティは、列に値を表示するときに適用する書式を指定します。たとえば、値の書式を地域通貨として指定する場合は、このプロパティを "c" に設定します。実際の通貨書式を確認するために、コンピュータの CultureInfo が使用されます。この値は、データが変更されると自動的に書式が解除され、ネイティブ型になります。

書式指定文字の詳細については、「日付と時刻の書式指定文字列」と「標準の数値書式指定文字列」を参照してください。

適用する書式は、データ型に適したものにする必要があります。たとえば、データが数値の場合は、数値の書式指定文字列を使用します。

DataGridTextBoxColumn の CultureInfo を変更するには、FormatInfo プロパティに、適切なカルチャ ID を指定して生成した新しい CultureInfo インスタンスを設定します。

アプリケーションの CultureInfo を設定するには、Application オブジェクトの CurrentCulture プロパティに、適切なカルチャ ID を指定して生成した新しい CultureInfo インスタンスを設定します。

使用例

新しい CultureInfo オブジェクトを作成し、そのオブジェクトを DataGridTextBoxColumn オブジェクトの FormatInfo プロパティに割り当てる例を次に示します。この例では、列の値を通貨として表示することを指定するために、Format プロパティを "c" に設定しています。

Visual Basic

Public Class Form1:Inherits Form
private myDataGrid as DataGrid    
    Public Shared Sub Main()
        Dim t As New Form1()
        ' Write a purchase order.
    End Sub
Private Sub ChangeColumnCultureInfo()
   ' Create a new CultureInfo object using the 
   ' the locale ID for Italy. 
   Dim ItalyCultureInfo As CultureInfo = New
 _
   CultureInfo(&H0410)
   ' Cast a column that holds numeric values to the   
   ' DataGridTextBoxColumn type, and set the FormatInfo
   ' property to the new CultureInfo object. 
   Dim myGridTextBoxColumn As DataGridTextBoxColumn
 = _
   CType( myDataGrid.TableStyles("Orders"). _
   GridColumnStyles("OrderAmount"), DataGridTextBoxColumn)
   myGridTextBoxColumn.FormatInfo = ItalyCultureInfo
   myGridTextBoxColumn.Format = "c"
End Sub

private void ChangeColumnCultureInfo(){
   /* Create a new CultureInfo object using
 the 
   the locale ID for Italy. */
   System.Globalization.CultureInfo ItalyCultureInfo= 
   new CultureInfo(0x0410);
     
   /* Cast a column that holds numeric values to the   
   DataGridTextBoxColumn type, and set the FormatInfo
   property to the new CultureInfo object. */
   DataGridTextBoxColumn myGridTextBoxColumn = 
   (DataGridTextBoxColumn) myDataGrid.TableStyles["Orders"].
   GridColumnStyles["OrderAmount"];
   myGridTextBoxColumn.FormatInfo = ItalyCultureInfo;
   myGridTextBoxColumn.Format = "c";
}

C++

private:
   void ChangeColumnCultureInfo()
   {
      /* Create a new CultureInfo Object* using
 the
        the locale ID for Italy. */
      System::Globalization::CultureInfo^ ItalyCultureInfo = gcnew CultureInfo( 0x0410
 );
      
      /* Cast a column that holds numeric values to the
        DataGridTextBoxColumn type, and set the FormatInfo
        property to the new CultureInfo Object*. */
      DataGridTextBoxColumn^ myGridTextBoxColumn =
         dynamic_cast<DataGridTextBoxColumn^>(myDataGrid->TableStyles[ "Orders"
 ]->
         GridColumnStyles[ "OrderAmount" ]);
      myGridTextBoxColumn->FormatInfo = ItalyCultureInfo;
      myGridTextBoxColumn->Format = "c";
   }

private void ChangeColumnCultureInfo()
{
    /* Create a new CultureInfo object using
 the the locale ID for Italy.*/
    System.Globalization.CultureInfo ItalyCultureInfo = 
        new CultureInfo(0x410);

    /* Cast a column that holds numeric values to the DataGridTextBoxColumn 
       type, and set the FormatInfo property to the new
 CultureInfo object.
     */
    DataGridTextBoxColumn myGridTextBoxColumn = 
        ((DataGridTextBoxColumn)(myDataGrid.get_TableStyles().
        get_Item("Orders").get_GridColumnStyles().
        get_Item("OrderAmount")));

    myGridTextBoxColumn.set_FormatInfo(ItalyCultureInfo);
    myGridTextBoxColumn.set_Format("c");
} //ChangeColumnCultureInfo

JScript

private function ChangeColumnCultureInfo(){
   // Create a new CultureInfo object using the 
   // the locale ID for Italy. 
   var ItalyCultureInfo : System.Globalization.CultureInfo = new
 CultureInfo(0x0410);
     
   // Cast a column that holds numeric values to the   
   // DataGridTextBoxColumn type, and set the FormatInfo
   // property to the new CultureInfo object. 
   var myGridTextBoxColumn : DataGridTextBoxColumn = 
   DataGridTextBoxColumn(myDataGrid.TableStyles["Orders"].
   GridColumnStyles["OrderAmount"]);
   
   myGridTextBoxColumn.FormatInfo = ItalyCultureInfo;
   myGridTextBoxColumn.Format = "c";
}