ListObject.DataBoundFormatSettings Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ab oder legt fest, welche FormatSettings von dem angegebenen XlRangeAutoFormat für das ListObject-Steuerelement übernommen werden.
public Microsoft.Office.Tools.Excel.FormatSettings DataBoundFormatSettings { get; set; }
Eigenschaftswert
Eine bitweise Kombination der FormatSettings-Werte.
Beispiele
Im folgenden Codebeispiel werden ein DataTable und ein erstellt ListObject und die ListObject an die gebunden DataTable . Anschließend wird der auf festgelegt, und es wird FormatSettings ListObject ein- XlRangeAutoFormat Wert verwendet, um das Format bereitzustellen.
Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.
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"], "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;
}
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
Hinweise
Standardmäßig werden alle Informationen im XlRangeAutoFormat Stil angewendet. Allerdings können bestimmte Elemente entfernt werden, sodass der Stil nicht auf diese Elemente angewendet wird. Diese Elemente lauten wie folgt:
Anzahl
Schriftart
Ausrichtung
Rahmen
Muster
Breite
Legen Sie DataBoundFormatSettings vor dem Festlegen der-Eigenschaft fest, dass nur ausgewählte Stile angewendet werden DataBoundFormat . DataBoundFormatSettingsfunktioniert nicht, wenn DataBoundFormat bereits festgelegt ist.