ListObject.DataBoundFormatSettings 属性
获取或设置要向 ListObject 控件应用指定 XlRangeAutoFormat 的哪个 FormatSettings。
命名空间: Microsoft.Office.Tools.Excel
程序集: Microsoft.Office.Tools.Excel(在 Microsoft.Office.Tools.Excel.dll 中)
语法
声明
Property DataBoundFormatSettings As FormatSettings
Get
Set
FormatSettings DataBoundFormatSettings { get; set; }
属性值
类型:Microsoft.Office.Tools.Excel.FormatSettings
FormatSettings 值的按位组合。
备注
默认情况下,将应用 XlRangeAutoFormat 样式中的所有信息。 但是,可以移除特定项,以便不将该样式应用于这些项。 这些项是:
Number
字体
对齐方式
Border
模式
宽度
若要只应用选定的样式,请在设置 DataBoundFormat 属性之前设置 DataBoundFormatSettings。 如果已设置 DataBoundFormat,则 DataBoundFormatSettings 不适用。
示例
下面的代码示例创建一个 DataTable 和一个 ListObject,并将该 ListObject 绑定到该 DataTable。 然后设置 FormatSettings,以便将其应用于 ListObject,并使用 XlRangeAutoFormat 值提供该格式。
此示例针对的是文档级自定义项。
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;
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。