WriteProtection 类 
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
写入保护。
此类在 Office 2007 及更高版本中可用。
当对象序列化为 xml 时,其限定名称为 w:writeProtection。
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(23, "writeProtection")]
public class WriteProtection : DocumentFormat.OpenXml.OpenXmlLeafElementpublic class WriteProtection : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr(23, "writeProtection")]
public class WriteProtection : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("w:writeProtection")]
public class WriteProtection : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("w:writeProtection")]
public class WriteProtection : DocumentFormat.OpenXml.TypedOpenXmlLeafElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class WriteProtection : DocumentFormat.OpenXml.OpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(23, "writeProtection")>]
type WriteProtection = class
    inherit OpenXmlLeafElementtype WriteProtection = class
    inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr(23, "writeProtection")>]
type WriteProtection = class
    inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("w:writeProtection")>]
type WriteProtection = class
    inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("w:writeProtection")>]
type WriteProtection = class
    inherit TypedOpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type WriteProtection = class
    inherit OpenXmlLeafElementPublic Class WriteProtection
Inherits OpenXmlLeafElementPublic Class WriteProtection
Inherits TypedOpenXmlLeafElement- 继承
- 继承
- 属性
注解
[ISO/IEC 29500-1 第 1 版]
writeProtection (Write Protection)
此元素指定已应用于 WordprocessingML 文档的写入保护设置。 写入保护 是指无法编辑文档内容的模式,并且不能使用相同的文件名重新保存文档。 此设置独立于 documentProtection (§17.15.1.29) 元素,但与文档保护一样,此设置不用作安全功能,可以忽略。
如果存在,写入保护应导致以下两种写入保护行为之一:
- 如果存在密码属性,或者省略了两个属性,则应用程序应提示输入密码以退出写入保护。 如果提供的密码与此属性中的哈希值不匹配,则应启用写入保护。 
- 如果仅存在建议的属性,则应用程序应提供用户界面,建议用户以写入保护状态打开此文档。 如果用户选择这样做,文档应受到写入保护,否则,文档应完全可编辑打开。 
如果省略此元素,则不应对当前文档应用任何写入保护。
[示例:请考虑一个 WordprocessingML 文档,该文档可以打开,但只能处于写入保护状态,除非提供密码,在这种情况下,文件将处于可编辑状态打开。 将在文档设置中使用以下 WordprocessingML 指定此要求:
<w:writeProtection w:hash="9oN7nWkCAyEZib1RomSJTjmPpCY=" />   
writeProtection 元素存在,该元素指定必须为此文档启用写入保护。 由于 password 属性等于 9oN7nWkCAyEZib1RomSJTjmPpCY= 给定 WordprocessingML 文档只能以写入保护状态打开,除非提供了与哈希值 *9oN7nWkCAyEZib1RomSJTjmPpCY=*匹配的密码;在这种情况下,文件将处于可编辑状态打开。 示例结束]
| 父元素 | 
|---|
| settings (§17.15.1.78) | 
[注意:此元素的内容模型 (CT_WriteProtection) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]
ISO/IEC29500:2008。
构造函数
| WriteProtection() | 初始化 WriteProtection 类的新实例。 | 
属性
| AlgorithmIdExtensibility | 加密算法扩展性 表示架构中的以下属性:w:algIdExt | 
| AlgorithmIdExtensibilitySource | 算法扩展性源 表示架构中的以下属性:w:algIdExtSource | 
| AlgorithmName | algorithmName,此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性:w:algorithmName | 
| ChildElements | 获取当前元素的所有子节点。(继承自 OpenXmlElement) | 
| CryptographicAlgorithmClass | 加密算法类 表示架构中的以下属性:w:cryptAlgorithmClass | 
| CryptographicAlgorithmSid | 加密哈希算法 表示架构中的以下属性:w:cryptAlgorithmSid | 
| CryptographicAlgorithmType | 加密算法类型 表示架构中的以下属性:w:cryptAlgorithmType | 
| CryptographicProvider | 加密提供程序 表示架构中的以下属性:w:cryptProvider | 
| CryptographicProviderType | 加密提供程序类型 表示架构中的以下属性:w:cryptProviderType | 
| CryptographicProviderTypeExtensibility | 加密提供程序类型扩展性 表示架构中的以下属性:w:cryptProviderTypeExt | 
| CryptographicProviderTypeExtSource | 提供程序类型扩展性源 表示架构中的以下属性:w:cryptProviderTypeExtSource | 
| CryptographicSpinCount | 运行哈希算法的迭代 表示架构中的以下属性:w:cryptSpinCount | 
| ExtendedAttributes | 获取当前元素的架构) 中未定义的所有扩展属性 (属性。(继承自 OpenXmlElement) | 
| Features | IFeatureCollection获取当前元素的 。 此功能集合将是只读的,但会从其父部件和包继承功能(如果可用)。(继承自 OpenXmlElement) | 
| FirstChild | 获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。(继承自 OpenXmlElement) | 
| HasAttributes | 获取一个值,该值指示当前元素是否具有任何属性。(继承自 OpenXmlElement) | 
| HasChildren | 获取一个值,该值指示当前元素是否具有任何子元素。(继承自 OpenXmlLeafElement) | 
| Hash | 密码哈希 表示架构中的以下属性:w:hash | 
| HashValue | hashValue,此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性:w:hashValue | 
| InnerText | 获取或设置节点及其所有子级的串联值。(继承自 OpenXmlElement) | 
| InnerXml | 获取或设置仅表示当前元素的子元素的标记。(继承自 OpenXmlLeafElement) | 
| LastChild | 获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。(继承自 OpenXmlElement) | 
| LocalName | 写入保护。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时,其限定名称为 w:writeProtection。 | 
| LocalName | 获取当前元素的本地名称。(继承自 OpenXmlElement) | 
| MCAttributes | 获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性,则返回 null。(继承自 OpenXmlElement) | 
| NamespaceDeclarations | 获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明,则返回空枚举器。(继承自 OpenXmlElement) | 
| NamespaceUri | 获取当前元素的命名空间 URI。(继承自 OpenXmlElement) | 
| OpenXmlElementContext | 获取当前元素的 OpenXmlElementContext。(继承自 OpenXmlElement) | 
| OuterXml | 获取表示当前元素及其所有子元素的标记。(继承自 OpenXmlElement) | 
| Parent | 获取当前元素的父元素。(继承自 OpenXmlElement) | 
| Prefix | 获取当前元素的命名空间前缀。(继承自 OpenXmlElement) | 
| Recommended | 在用户界面中推荐写入保护 表示架构中的以下属性:w:recommended | 
| Salt | 密码验证程序 Salt 表示架构中的以下属性:w:salt | 
| SaltValue | saltValue,此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性:w:saltValue | 
| SpinCount | spinCount,此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性:w:spinCount | 
| XmlQualifiedName | 获取当前元素的限定名称。(继承自 OpenXmlElement) | 
| XName | 获取当前元素的限定名称。(继承自 OpenXmlElement) | 
方法
| AddAnnotation(Object) | 将 对象添加到当前 OpenXmlElement 元素的批注列表中。(继承自 OpenXmlElement) | 
| 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) | 将指定的元素追加到当前元素的子节点列表的末尾。(继承自 OpenXmlElement) | 
| 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) | 在指定的引用元素之后立即插入指定的元素。(继承自 OpenXmlElement) | 
| InsertAfterSelf<T>(T) | 在当前元素之后立即插入指定的元素。(继承自 OpenXmlElement) | 
| InsertAt<T>(T, Int32) | 在当前元素的子元素列表中指定索引处插入指定的元素。(继承自 OpenXmlElement) | 
| InsertBefore<T>(T, OpenXmlElement) | 将指定的元素紧接在指定的引用元素之前。(继承自 OpenXmlElement) | 
| 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) | 在当前元素的子元素列表的开头插入指定的元素。(继承自 OpenXmlElement) | 
| PreviousSibling() | 获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素,则返回 null (Visual Basic ) 中 Nothing。(继承自 OpenXmlElement) | 
| PreviousSibling<T>() | 获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。(继承自 OpenXmlElement) | 
| Remove() | 从其父元素中删除当前元素。(继承自 OpenXmlElement) | 
| RemoveAllChildren() | 删除当前元素的所有子元素。(继承自 OpenXmlLeafElement) | 
| RemoveAllChildren<T>() | 删除类型为 T 的当前元素的所有子元素。(继承自 OpenXmlElement) | 
| RemoveAnnotations(Type) | 从当前 OpenXmlElement 元素中删除指定类型的注释。(继承自 OpenXmlElement) | 
| RemoveAnnotations<T>() | 从当前 OpenXmlElement 元素中删除具有指定类型的批注。(继承自 OpenXmlElement) | 
| RemoveAttribute(String, String) | 从当前元素中删除 属性。(继承自 OpenXmlElement) | 
| RemoveChild<T>(T) | 从当前元素的子元素列表中删除指定的子元素。(继承自 OpenXmlElement) | 
| RemoveNamespaceDeclaration(String) | 删除指定前缀的命名空间声明。 如果没有前缀,则不删除任何内容。(继承自 OpenXmlElement) | 
| ReplaceChild<T>(OpenXmlElement, T) | 将子元素替换为当前元素的子元素列表中的另一个子元素。(继承自 OpenXmlElement) | 
| SetAttribute(OpenXmlAttribute) | 将特性设置为指定的元素。 如果该属性是已知属性,则设置该特性的值。 如果该属性是扩展属性,则会将“openxmlAttribute”添加到扩展属性列表中。(继承自 OpenXmlElement) | 
| SetAttributes(IEnumerable<OpenXmlAttribute>) | 设置元素的多个属性。 如果属性是已知属性,则会设置该属性的值。 如果属性是扩展属性,则会将“openxmlAttribute”添加到扩展属性列表中。(继承自 OpenXmlElement) | 
| WriteTo(XmlWriter) | 将当前节点保存到指定的 XmlWriter。(继承自 OpenXmlElement) | 
显式接口实现
| IEnumerable.GetEnumerator() | 写入保护。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时,其限定名称为 w:writeProtection。(继承自 OpenXmlElement) | 
| IEnumerable<OpenXmlElement>.GetEnumerator() | 返回循环访问子集合的枚举器。(继承自 OpenXmlElement) |