FormatSettings-Enumeration

Artikel
08/10/2011

Legt den Formatierungstyp fest, der auf das ListObject angewendet wird, wenn dieses an Daten gebunden ist.

Diese Enumeration verfügt über ein FlagsAttribute-Attribut, das die bitweise Kombination der Memberwerte zulässt.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration FormatSettings

[FlagsAttribute]
public enum FormatSettings

Member

	Membername	Beschreibung
	Number	Gibt an, ob die Zahlenformate in den vordefinierten XlRangeAutoFormat aufgenommen werden sollen.
	Font	Gibt an, ob Schriftartformate in den vordefinierten XlRangeAutoFormat aufgenommen werden sollen.
	Alignment	Gibt an, ob eine Ausrichtung in den vordefinierten XlRangeAutoFormat aufgenommen werden soll.
	Border	Gibt an, ob Rahmenformate in den vordefinierten XlRangeAutoFormat aufgenommen werden sollen.
	Pattern	Gibt an, ob die Musterformate in den vordefinierten XlRangeAutoFormat aufgenommen werden sollen.
	Width	Gibt an, ob die Spaltenbreite und die Zeilenhöhe in den vordefinierten XlRangeAutoFormat aufgenommen werden sollen.

Hinweise

Es gibt sechs Einstellungen, die zum Angeben des Formats kombiniert werden können. Mit dieser Enumeration können Sie die auf das ListObject anzuwendenden Eigenschaften auswählen. Standardmäßig werden alle Formateinstellungen übernommen.

Beispiele

Im folgenden Codebeispiel werden eine DataTable und ein ListObject erstellt, und das ListObject wird an die DataTable gebunden. Anschließend werden die Schriftart- und Musterformate eines vordefinierten XlRangeAutoFormat-Werts auf das ListObject angewendet.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    Private Sub ListObject_DataBoundFormatSettings()
        ' Create a new DataSet and DataTable.
        Dim ds As New DataSet()
        Dim dt As DataTable = ds.Tables.Add("Customers")
        dt.Columns.Add(New DataColumn("LastName"))
        dt.Columns.Add(New DataColumn("FirstName"))

        ' Add a new row to the DataTable.
        Dim dr As DataRow = dt.NewRow()
        dr("LastName") = "Chan"
        dr("FirstName") = "Gareth"
        dt.Rows.Add(dr)

        ' Create a list object.
        Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
            Me.Controls.AddListObject(Me.Range( _
            "A1"), "List1")

        ' Bind the list object to the DataTable.
        List1.AutoSetDataBoundColumnHeaders = True
        List1.SetDataBinding(ds, "Customers", _
            "LastName", "FirstName")

        ' Specify the format settings that you want to include.
        ' In this example, only the Font and Pattern 
        ' settings are applied.
        List1.DataBoundFormatSettings = _
            Microsoft.Office.Tools.Excel.FormatSettings.Font Or _
            Microsoft.Office.Tools.Excel.FormatSettings.Pattern

        ' Add a format to the list object.
        List1.DataBoundFormat = _
            Excel.XlRangeAutoFormat.xlRangeAutoFormatList2

    End Sub

private void ListObject_DataBoundFormatSettings()
{
    // Create a new DataSet and DataTable.
    DataSet ds = new DataSet();
    DataTable dt = ds.Tables.Add("Customers");
    dt.Columns.Add(new DataColumn("LastName"));
    dt.Columns.Add(new DataColumn("FirstName"));

    // Add a new row to the DataTable.
    DataRow dr = dt.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    dt.Rows.Add(dr);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1", missing], "list1");

    // Bind the list object to the DataTable.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.SetDataBinding(ds, "Customers", "LastName",
        "FirstName");

    // Specify the format settings that you want to include.
    // In this example, only the Font and Pattern 
    // settings are applied.
    list1.DataBoundFormatSettings =
        Microsoft.Office.Tools.Excel.FormatSettings.Font |
        Microsoft.Office.Tools.Excel.FormatSettings.Pattern;

    // Add a format to the list object.
    list1.DataBoundFormat = 
        Excel.XlRangeAutoFormat.xlRangeAutoFormatList2;
}

Siehe auch

Referenz

Microsoft.Office.Tools.Excel-Namespace

Share via