ProtectedRange Classe

Definição

Namespace:

DocumentFormat.OpenXml.Office2010.Excel

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Define a Classe ProtectedRange.

Esta classe está disponível no Office 2010 e superior.

Quando o objeto é serializado como xml, o nome qualificado é x14:protectedRange.

public class ProtectedRange : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ProtectedRange = class
    inherit OpenXmlCompositeElement

Public Class ProtectedRange
Inherits OpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

ProtectedRange

Comentários

2.6.56 CT_ProtectedRange

Espaço de nomes de destino:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

Referenciado por: CT_ProtectedRanges

Um tipo complexo que especifica um intervalo de células a ser desprotegido. O intervalo de células é editável com uma palavra-passe ou credenciais adequadas quando a proteção da folha (1) está ativada e a célula está bloqueada.

Elementos Subordinados:

xm:sqref: Um elemento sqref que especifica o intervalo de células a ser desprotegido.

Atributos:

palavra-passe: Um atributo ST_UnsignedShortHex ([ISO/IEC-29500-4] secção 10.7.2) que especifica o valor de verificador da palavra-passe necessária para editar o intervalo de células. Se o valor for 0x0000, não existe palavra-passe.

O valor do verificador é calculado em duas fases. Primeiro, a cadeia de palavra-passe Unicode fornecida é convertida numa nova cadeia de carateres na página de código ANSI do sistema atual ao utilizar o algoritmo especificado no atributo revisionsPassword na secção [ISO/IEC-29500-1] 18.2.29. Em segundo lugar, esta cadeia é inserida no algoritmo de obfuscação XOR especificado na secção [MS-OFFCRYPTO] 2.3.7.1 para produzir um valor de verificador de palavras-passe de 16 bits.

Este atributo NÃO PODE estar presente se algorithmName estiver presente.

algorithmName: Um atributo ST_Xstring ([ISO/IEC-29500-1] da secção 22.9.2.19) que especifica o nome do algoritmo hash utilizado para calcular o hashValue. Se este atributo estiver presente, hashValue, saltValue e spinCount MUST também estarão presentes. Este atributo NÃO PODE estar presente se a palavra-passe estiver presente.

hashValue: Um atributo base64Binary ([XMLSCHEMA2] secção 3.2.16) que especifica o valor hash da palavra-passe necessária para editar este intervalo. Este valor será comparado com o valor hash resultante após o hash da palavra-passe fornecida pelo utilizador com o algoritmo especificado por algorithmName e, se os dois valores corresponderem, a proteção deixará de ser imposta.

Os hashes de palavras-passe são calculados pelo algoritmo especificado na secção [MS-OFFCRYPTO] 2.4.2.4. Em algumas circunstâncias, a palavra-passe é primeiro convertida num valor de verificador de 16 bits e reinterpretada como um único caráter Unicode, que é depois transmitida para o algoritmo especificado na secção [MS-OFFCRYPTO] 2.4.2.4. Não é possível determinar que método foi utilizado para gerar um hash sem ter conhecimento da palavra-passe; é necessário calcular ambos os hashes para verificar a palavra-passe.

Este atributo TEM de estar presente se e apenas se algorithmName estiver presente.

saltValue: Um atributo base64Binary ([XMLSCHEMA2] secção 3.2.16) que especifica o sal utilizado para calcular hashValue. Este atributo TEM de estar presente se e apenas se algorithmName estiver presente.

spinCount: Um atributo unsignedInt ([XMLSCHEMA2] secção 3.3.22) que especifica o número de vezes que a função hash foi iterada sobre a palavra-passe para gerar o hashValue. NÃO PODE ser superior a 10 000 000. Este atributo TEM de estar presente se e apenas se algorithmName estiver presente.

name: Um atributo ST_Xstring ([ISO/IEC-29500-1] da secção 22.9.2.19) que especifica o título do intervalo de células. O valor TEM de ser exclusivo para a folha (1). O número de carateres na cadeia TEM de ser maior ou igual a 1 e menor ou igual a 255. A cadeia TEM de estar em conformidade com a seguinte gramática do Formulário de Backus-Naur Aumentado (ABNF) ([RFC5234]):

string = name-start-character *name-character

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

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

Os seguintes pontos resumem esta gramática:

\Unicode-character é qualquer ponto de código que seja um caráter conforme definido pelas propriedades do caráter Unicode, [UNICODE5.1] capítulo 4.

\Unicode-digit é qualquer ponto de código que seja um dígito conforme definido pelas propriedades do caráter Unicode, [UNICODE5.1] capítulo 4.

\Unicode-space é qualquer ponto de código que seja um espaço conforme definido pelas propriedades do caráter Unicode, [UNICODE5.1] capítulo 4.

securityDescriptor: Um atributo de cadeia ([XMLSCHEMA2] secção 3.2.1) que especifica um descritor de segurança ([MS-WSO] secção 3.1.2.3.2) que lista os utilizadores que podem editar o intervalo de células sem fornecer a palavra-passe.

O seguinte fragmento de Esquema XML W3C ([XMLSCHEMA1] secção 2.1) especifica os conteúdos deste tipo complexo.

<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>

Veja a secção 5.4 para obter o Esquema W3C XML completo ([XMLSCHEMA1] secção 2.1).

Construtores

ProtectedRange()	Inicializa uma nova instância da classe ProtectedRange.
ProtectedRange(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe ProtectedRange com os elementos subordinados especificados.
ProtectedRange(OpenXmlElement[])	Inicializa uma nova instância da classe ProtectedRange com os elementos subordinados especificados.
ProtectedRange(String)	Inicializa uma nova instância da classe ProtectedRange do XML externo.

Propriedades

AlgorithmName	algorithmName, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: algorithmName
ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro elemento subordinado do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos subordinados. (Herdado de OpenXmlCompositeElement)
HashValue	hashValue, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: hashValue
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os respetivos subordinados. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós subordinados do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
Name	name, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: nome
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
OuterXml	Obtém a marcação que representa o elemento atual e todos os respetivos elementos subordinados. (Herdado de OpenXmlElement)
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Password	palavra-passe, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: palavra-passe
Prefix	Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
ReferenceSequence	ReferenceSequence. Representa a seguinte etiqueta de elemento no esquema: xne:sqref.
SaltValue	saltValue, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: saltValue
SecurityDescriptor	securityDescriptor, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: securityDescriptor
SpinCount	spinCount, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: spinCount
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento subordinado no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado dos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento subordinado especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos subordinados do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Define a Classe ProtectedRange. Esta classe está disponível no Office 2010 e superior. Quando o objeto é serializado como xml, o nome qualificado é x14:protectedRange. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)