ProtectedRange Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Office2010.Excel

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Define la clase ProtectedRange.

Esta clase está disponible en Office 2010 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es x14:protectedRange.

public class ProtectedRange : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ProtectedRange = class
    inherit OpenXmlCompositeElement

Public Class ProtectedRange
Inherits OpenXmlCompositeElement

Herencia

Object

OpenXmlElement

OpenXmlCompositeElement

ProtectedRange

Comentarios

2.6.56 CT_ProtectedRange

Espacio de nombres de destino:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

A la que hace referencia: CT_ProtectedRanges

Tipo complejo que especifica un intervalo de celdas que se va a desproteger. El intervalo de celdas se puede editar con una contraseña o credenciales adecuadas cuando la protección de hoja (1) está activada y la celda está bloqueada.

Elementos secundarios:

xm:sqref: Elemento sqref que especifica el intervalo de celdas que se va a desproteger.

Atributos:

Contraseña: Atributo de ST_UnsignedShortHex ([ISO/IEC-29500-4] sección 10.7.2) que especifica el valor del comprobador de la contraseña necesaria para editar el intervalo de celdas. Si el valor se 0x0000, no hay ninguna contraseña.

El valor del comprobador se calcula en dos fases. En primer lugar, la cadena de contraseña Unicode proporcionada se convierte en una nueva cadena de caracteres en la página de códigos ANSI del sistema actual mediante el algoritmo especificado en el atributo revisionsPassword de la sección 18.2.29 de [ISO/IEC-29500-1]. En segundo lugar, esta cadena se introduce en el algoritmo de ofuscación XOR especificado en la sección 2.3.7.1 de [MS-OFFCRYPTO] para generar un valor de comprobador de contraseña de 16 bits.

Este atributo NO DEBE estar presente si algorithmName está presente.

algorithmName: Atributo de ST_Xstring ([ISO/IEC-29500-1] sección 22.9.2.19) que especifica el nombre del algoritmo hash usado para calcular hashValue. Si este atributo está presente, hashValue, saltValue y spinCount también deben estar presentes. Este atributo NO DEBE estar presente si la contraseña está presente.

hashValue: Atributo base64Binary ([XMLSCHEMA2] sección 3.2.16) que especifica el valor hash de la contraseña necesaria para editar este intervalo. Este valor se comparará con el valor hash resultante después de aplicar hash a la contraseña proporcionada por el usuario mediante el algoritmo especificado por algorithmName y, si los dos valores coinciden, ya no se aplicará la protección.

Los hashes de contraseña se calculan mediante el algoritmo especificado en la sección 2.4.2.4 de [MS-OFFCRYPTO]. En algunas circunstancias, la contraseña se convierte primero en un valor comprobador de 16 bits y se reinterpreta como un único carácter Unicode, que luego se pasa al algoritmo especificado en la sección 2.4.2.4 de [MS-OFFCRYPTO]. No hay ninguna manera de determinar qué método se usó para generar un hash sin conocimiento de la contraseña; es necesario calcular ambos hashes para comprobar la contraseña.

Este atributo DEBE estar presente si y solo si algorithmName está presente.

saltValue: Atributo base64Binary ([XMLSCHEMA2] sección 3.2.16) que especifica la sal utilizada para calcular hashValue. Este atributo DEBE estar presente si y solo si algorithmName está presente.

spinCount: Atributo unsignedInt ([XMLSCHEMA2] section 3.3.22) que especifica el número de veces que se iteró la función hash sobre la contraseña para generar el valor hashValue. NO DEBE ser mayor que 10 000 000. Este atributo DEBE estar presente si y solo si algorithmName está presente.

Nombre: Atributo de ST_Xstring ([ISO/IEC-29500-1] sección 22.9.2.19) que especifica el título del intervalo de celdas. El valor debe ser único para la hoja (1). El número de caracteres de la cadena DEBE ser mayor o igual que 1 y menor o igual que 255. La cadena DEBE ajustarse a la siguiente gramática del formulario de Backus-Naur aumentada (ABNF) ([RFC5234]):

string = name-start-character *name-character

name-start-character = "_" / "\" / Unicode-character

name-character = name-start-character / Unicode-space / Unicode-digit / "?" / "."

En los puntos siguientes se resume esta gramática:

Carácter Unicode es cualquier punto de código que sea un carácter definido por las propiedades de caracteres Unicode, [UNICODE5.1] capítulo 4.

El dígito Unicode es cualquier punto de código que sea un dígito definido por las propiedades de caracteres Unicode, [UNICODE5.1] capítulo 4.

El espacio Unicode es cualquier punto de código que sea un espacio definido por las propiedades de caracteres Unicode, [UNICODE5.1] capítulo 4.

securityDescriptor: Atributo de cadena ([XMLSCHEMA2] sección 3.2.1) que especifica un descriptor de seguridad ([MS-WSO] sección 3.1.2.3.2) que enumera los usuarios que pueden editar el intervalo de celdas sin proporcionar la contraseña.

El siguiente fragmento de esquema XML W3C ([XMLSCHEMA1] sección 2.1) especifica el contenido de este tipo complejo.

<xsd:complexType name="CT_ProtectedRange">

<xsd:sequence maxOccurs="1">

<xsd:element ref="xm:sqref" minOccurs="1" maxOccurs="1"/>

</xsd:sequence>

<xsd:attribute name="password" type="x:ST_UnsignedShortHex" use="optional"/>

<xsd:attribute name="algorithmName" type="x:ST_Xstring" use="optional"/>

<xsd:attribute name="hashValue" type="xsd:base64Binary" use="optional"/>

<xsd:attribute name="saltValue" type="xsd:base64Binary" use="optional"/>

<xsd:attribute name="spinCount" type="xsd:unsignedInt" use="optional"/>

<xsd:attribute name="name" type="x:ST_Xstring" use="required"/>

<xsd:attribute name="securityDescriptor" type="xsd:string" use="optional"/>

</xsd:complexType>

Consulte la sección 5.4 para ver el esquema XML W3C completo ([XMLSCHEMA1] sección 2.1).

Constructores

ProtectedRange()	Inicializa una nueva instancia de la clase ProtectedRange.
ProtectedRange(IEnumerable<OpenXmlElement>)	Inicializa una nueva instancia de la clase ProtectedRange con los elementos secundarios especificados.
ProtectedRange(OpenXmlElement[])	Inicializa una nueva instancia de la clase ProtectedRange con los elementos secundarios especificados.
ProtectedRange(String)	Inicializa una nueva instancia de la clase ProtectedRange a partir de XML externo.

Propiedades

AlgorithmName	algorithmName, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: algorithmName
ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement actual. (Heredado de OpenXmlCompositeElement)
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlCompositeElement)
HashValue	hashValue, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: hashValue
InnerText	Obtiene o establece los valores concatenados del nodo actual y todos sus elementos secundarios. (Heredado de OpenXmlCompositeElement)
InnerXml	Obtiene o establece el marcado que representa solo los nodos secundarios del nodo actual. (Heredado de OpenXmlCompositeElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlCompositeElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
Name	name, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: name
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Password	contraseña, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: password
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
ReferenceSequence	ReferenceSequence. Representa la siguiente etiqueta de elemento en el esquema: xne:sqref.
SaltValue	saltValue, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: saltValue
SecurityDescriptor	securityDescriptor, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: securityDescriptor
SpinCount	spinCount, esta propiedad solo está disponible en Office 2010 y versiones posteriores. Representa el atributo siguiente en el esquema: spinCount
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Agrega el elemento especificado al elemento si es un elemento secundario conocido. Esto agrega el elemento en la ubicación correcta según el esquema. (Heredado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado de los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado. (Heredado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza uno de los elementos secundarios del elemento actual por otro elemento OpenXmlElement. (Heredado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Define la clase ProtectedRange. Esta clase está disponible en Office 2010 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es x14:protectedRange. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)