DataGridTextBoxColumn.Format-Eigenschaft

Ruft das bzw. die Zeichen ab, die angeben, wie Text formatiert wird, oder legt diese fest.

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

Syntax

'Declaration
Public Property Format As String
'Usage
Dim instance As DataGridTextBoxColumn
Dim value As String

value = instance.Format

instance.Format = value

public string Format { get; set; }

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

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

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

public function get Format () : String

public function set Format (value : String)

Eigenschaftenwert

Das bzw. die Zeichen, die angegeben, wie Text formatiert wird.

Hinweise

Die Format-Eigenschaft gibt an, wie Werte in der Spalte angezeigt werden. Durch Festlegen der Eigenschaft auf "c" wird z. B. angegeben, dass die Werte mit dem Format für die lokale Währung formatiert werden. Zum Bestimmen des tatsächlichen Währungsformats wird die CultureInfo des Computers verwendet. Beim Ändern von Daten wird die Formatierung der Werte automatisch aufgehoben und der systemeigene Typ verwendet.

Weitere Informationen zum Formatieren von Zeichen finden Sie unter Formatzeichenfolgen für Datum und Uhrzeit und Standardmäßige Zahlenformatzeichenfolgen.

Das zugewiesene Format sollte für den Datentyp geeignet sein. Für Daten in numerischer Form sollten z. B. numerische Formatzeichenfolgen verwendet werden.

Sie können die CultureInfo für eine DataGridTextBoxColumn ändern, indem Sie die FormatInfo-Eigenschaft auf eine neue, mit der entsprechenden Kultur-ID erstellte CultureInfo-Instanz festlegen.

Legen Sie zum Festlegen der CultureInfo für die Anwendung die CurrentCulture-Eigenschaft des Application-Objekts auf eine neue, mit einer entsprechenden Kultur-ID erstellte CultureInfo-Instanz fest.

Beispiel

Im folgenden Beispiel wird ein neues CultureInfo-Objekt erstellt und der FormatInfo-Eigenschaft eines DataGridTextBoxColumn-Objekts zugewiesen. Außerdem wird im Beispiel die Format-Eigenschaft auf "c" festgelegt, um anzugeben, dass Werte in der Spalte als Währung angezeigt werden sollen.

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

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

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

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

Siehe auch

Referenz

DataGridTextBoxColumn-Klasse
DataGridTextBoxColumn-Member
System.Windows.Forms-Namespace
CultureInfo
FormatInfo