CustomWorkbookView 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

自定义工作簿视图。

此类在 Office 2007 及更高版本中可用。

当对象序列化为 xml 时，其限定名称为 x：customWorkbookView。

public class CustomWorkbookView : DocumentFormat.OpenXml.OpenXmlCompositeElement

type CustomWorkbookView = class
    inherit OpenXmlCompositeElement

Public Class CustomWorkbookView
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

CustomWorkbookView

注解

[ISO/IEC 29500-1 第 1 版]

customWorkbookView (自定义工作簿视图)

此元素指定单个自定义工作簿视图。 自定义工作簿视图包含一组可命名并应用于工作簿的显示和打印设置。 可以创建同一工作簿的多个自定义工作簿视图。 构建有效的 SpreadsheetML 文档不需要自定义工作簿视图;如果电子表格应用程序从未显示文档，或者电子表格应用程序具有工作簿的固定显示，则不需要自定义工作簿视图。 但是，如果电子表格应用程序选择实现可配置的显示模式，则应使用 customWorkbookView 元素来保留这些显示模式的设置。 这些设置分为以下类别，下表中详细介绍了各个设置：

窗口设置 - 包括电子表格窗口的大小和位置，以及应 (滚动条、工作表选项卡等 ) 显示哪些窗口功能。

工作簿内容显示和打印设置 - 指定在显示或打印自定义工作簿视图时，电子表格应用程序应包含或忽略工作簿中的功能。 [示例：是否应显示工作簿中的注释以及图像等对象应如何显示，可由自定义工作簿视图控制。 示例结束]

持久性设置 - 这些设置包括描述当多个电子表格应用程序同时访问 SpreadsheetML 文档的常见实例时，电子表格应用程序应如何更新持久保存的 SpreadsheetML 内容的设置。

当存在自定义工作簿视图时，工作簿中每个工作表 (§18.2.1.19) 还应有相应的 customSheetView (§18.3.1.25) 元素。 这些 customSheetView 元素的 guid 属性将 customSheetView 与相应的 customWorkbookView 相关联。 如果显示自定义工作簿视图，则应使用 customWorkbookView 元素的属性来确定电子表格应用程序应遵循自定义工作表视图中的哪些设置。

父元素
customWorkbookViews (§18.2.4)

子元素	第
extLst (Future Feature Data Storage Area)	§18.2.10

属性	说明
activeSheetId (书籍视图中的活动工作表)	指定工作簿中工作表的 sheetId，该工作表向使用应用程序标识要显示的默认工作表。 对应于工作表集合中工作表的 sheetId。 此特性是必需的。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
autoUpdate (自动更新)	指定一个布尔值，该值指示如果工作簿由电子表格应用程序加载，则电子表格应用程序应按 mergeInterval 属性指定的间隔自动更新更改。 这仅适用于 (§18.11) 的共享工作簿。 值 1 或 true 是电子表格应用程序的指令，用于在 mergeInterval 属性中指定的间隔内更新更改。 值 0 或 false 是每当电子表格应用程序生成表示工作簿的 SpreadsheetML 时，电子表格应用程序的更新更改的指令。 此属性的默认值为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
changesSavedWin (更改保存的 Win)	指定一个布尔值，该值指示电子表格应用程序使用保留的更新版本覆盖文档的持久版本。 这仅适用于自动更新模式下的共享工作簿。 如果值为 1 或 true ，则指示电子表格应用程序在发现数据冲突时覆盖共享工作簿的持久化版本中的更改。 如果值为 0 或 false ，则指示电子表格应用程序在发现冲突时不覆盖共享工作簿的持久化版本中的更改。 此属性的默认值为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
guid (自定义视图 GUID)	指定此自定义视图的全局唯一标识符 (GUID) 此属性的可能值由 ST_Guid 简单类型 (§22.9.2.4) 定义。
includeHiddenRowCol (包括隐藏行 & 列)	指定一个布尔值，该值指示是否在此自定义视图中包括隐藏的行、列和筛选器设置。 值为 1 或 true 表示隐藏的行、列和筛选器设置包含在此自定义视图中。 值为 0 或 false 表示不包括隐藏的行、列和筛选器设置。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
includePrintSettings (包括打印设置)	指定一个布尔值，该值指示是否在此自定义视图中包括打印设置。 值为 1 或 true 表示打印设置已包含在此自定义视图中。 值为 0 或 false 表示打印设置未包含在此自定义视图中。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
最大化 (最大化)	指定一个布尔值，该值指示工作簿窗口是否最大化。 值为 1 或 true 表示工作簿窗口最大化。 值为 0 或 false 表示工作簿窗口未最大化。 此属性的默认值为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
mergeInterval (合并间隔)	自动更新间隔 (（以分钟为单位) ）。 仅适用于自动更新模式下的共享工作簿。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
最小化 (最小化)	指定一个布尔值，该值指示工作簿窗口是否最小化。 值为 1 或 true 表示工作簿窗口已最小化。 值为 0 或 false 表示工作簿窗口未最小化。 此属性的默认值为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
名称 (自定义视图名称)	指定自定义视图的名称。 此特性是必需的。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
onlySync (Only Synch)	指定一个布尔值，该值指示在自动更新期间不保存当前用户的更改。 工作簿仅更新其他用户的更改。 仅适用于自动更新模式下的共享工作簿。 值为 1 或 true 表示自动更新期间未保存当前用户的更改。 值为 0 或 false 表示在自动更新期间保存了当前用户的 。 此属性的默认值为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
personalView (个人视图)	指定一个布尔值，该值指示此自定义视图是共享工作簿用户的个人视图。 仅适用于共享工作簿。 个人视图允许共享工作簿的每个用户存储其单独的打印和筛选设置。 值为 1 或 true 表示此自定义视图是共享工作簿用户的个人视图。 值为 0 或 false 表示此视图不是个人视图。 此属性的默认值为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
showComments (显示注释)	指定注释在此自定义视图中的显示方式 此属性的可能值由 ST_Comments 简单类型 (§18.18.14) 定义。
showFormulaBar (显示编辑栏)	指定一个布尔值，该值指示是否在应用程序用户界面中显示编辑栏。 值为 1 或 true 表示编辑栏显示在用户界面中。 值为 0 或 false 表示用户界面中未显示编辑栏。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
showHorizontalScroll (显示水平滚动)	指定一个布尔值，该值指示是否在用户界面中显示水平滚动条。 值为 1 或 true 表示显示水平滚动条。 值为 0 或 false 表示不显示水平滚动条。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
showObjects (显示对象)	指定对象在此自定义视图中的显示方式。 此属性的默认值为“all”。 此属性的可能值由 ST_Objects 简单类型 (§18.18.48) 定义。
showSheetTabs (显示工作表选项卡)	指定一个布尔值，该值指示是否在用户界面中显示工作表选项卡。 值为 1 或 true 表示应显示工作表选项卡。 值为 0 或 false 表示不应显示工作表选项卡。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
showStatusbar (显示状态栏)	指定一个布尔值，该值指示是否在用户界面中显示状态栏。 值为 1 或 true 表示显示状态栏。 值为 0 或 false 表示未显示状态栏。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
showVerticalScroll (显示垂直滚动)	指定一个布尔值，该值指示是否显示垂直滚动条。 值为 1 或 true 表示应显示垂直滚动条。 值为 0 或 false 表示不应显示垂直滚动条。 此属性的默认值为 true。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
tabRatio (工作表制表符比率)	指定工作簿选项卡栏与水平滚动条之间的比率。 tabRatio 假定为水平窗口宽度的 1000。 此属性的默认值为 600。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
windowHeight (窗口高度)	指定工作簿窗口的高度。 此值的度量单位为 twips。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
windowWidth (窗口宽度)	指定工作簿窗口的宽度。 此值的度量单位为 twips。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
xWindow (左上角 (X 坐标) )	指定工作簿窗口左上角的 X 坐标。 此值的度量单位为 twips。 此属性的可能值由 W3C XML 架构 int 数据类型定义。
yWindow (左上角 (Y 坐标) )	指定工作簿窗口左上角的 Y 坐标。 此值的度量单位为 twips。 此属性的可能值由 W3C XML 架构 int 数据类型定义。

[注意：此元素的内容模型 (CT_CustomWorkbookView) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]

ISO/IEC29500：2008。

构造函数

CustomWorkbookView()	初始化 CustomWorkbookView 类的新实例。
CustomWorkbookView(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 CustomWorkbookView 类的新实例。
CustomWorkbookView(OpenXmlElement[])	使用指定的子元素初始化 CustomWorkbookView 类的新实例。
CustomWorkbookView(String)	从外部 XML 初始化 CustomWorkbookView 类的新实例。

属性

ActiveSheetId	书籍视图中的活动工作表 表示架构中的以下属性：activeSheetId
AutoUpdate	自动更新 表示架构中的以下属性：autoUpdate
ChangesSavedWin	更改已保存的赢 表示架构中的以下属性：changesSavedWin
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
ExtensionList	ExtensionList。 表示架构中的以下元素标记：x：extLst。
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
Guid	自定义视图 GUID 表示架构中的以下属性：guid
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
IncludeHiddenRowColumn	包括隐藏的行和列 表示架构中的以下属性：includeHiddenRowCol
IncludePrintSettings	包括打印设置 表示架构中的以下属性：includePrintSettings
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
Maximized	最大化 表示架构中的以下属性：最大化
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
MergeInterval	合并间隔 表示架构中的以下属性：mergeInterval
Minimized	最小化 表示架构中的以下属性： 最小化
Name	自定义视图名称 表示架构中的以下属性：name
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OnlySync	仅同步 表示架构中的以下属性：onlySync
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
PersonalView	个人视图 表示架构中的以下属性：personalView
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
ShowComments	显示注释 表示架构中的以下属性：showComments
ShowFormulaBar	显示编辑栏 表示架构中的以下属性：showFormulaBar
ShowHorizontalScroll	显示水平滚动 表示架构中的以下属性：showHorizontalScroll
ShowObjects	显示对象 表示架构中的以下属性：showObjects
ShowSheetTabs	显示工作表选项卡 表示架构中的以下属性：showSheetTabs
ShowStatusbar	显示状态栏 表示架构中的以下属性：showStatusbar
ShowVerticalScroll	显示垂直滚动 表示架构中的以下属性：showVerticalScroll
TabRatio	工作表制表符比率 表示架构中的以下属性：tabRatio
WindowHeight	窗口高度 表示架构中的以下属性：windowHeight
WindowWidth	窗口宽度 表示架构中的以下属性：windowWidth
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XWindow	左上角 (X 坐标) 表示架构中的以下属性：xWindow
YWindow	左上角 (Y 坐标) 表示架构中的以下属性：yWindow

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	自定义工作簿视图。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 x：customWorkbookView。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)