ProtectedRange Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Office2010.Excel

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Définit la classe ProtectedRange.

Cette classe est disponible dans Office 2010 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est x14 :protectedRange.

public class ProtectedRange : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ProtectedRange = class
    inherit OpenXmlCompositeElement

Public Class ProtectedRange
Inherits OpenXmlCompositeElement

Héritage

Object

OpenXmlElement

OpenXmlCompositeElement

ProtectedRange

Remarques

2.6.56 CT_ProtectedRange

Espace de noms cible :http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

Référencé par : CT_ProtectedRanges

Type complexe qui spécifie une plage de cellules à ne pas protéger. La plage de cellules est modifiable avec un mot de passe ou des informations d’identification appropriées lorsque la protection de la feuille (1) est activée et que la cellule est verrouillée.

Éléments enfants :

xm :sqref : Élément sqref qui spécifie la plage de cellules à ne pas protéger.

Attributs:

mot de passe: Attribut ST_UnsignedShortHex ([ISO/IEC-29500-4] section 10.7.2) qui spécifie la valeur du vérificateur du mot de passe requis pour modifier la plage de cellules. Si la valeur est 0x0000, il n’y a pas de mot de passe.

La valeur du vérificateur est calculée en deux étapes. Tout d’abord, la chaîne de mot de passe Unicode fournie est convertie en nouvelle chaîne de caractères dans la page de codes ANSI du système actuel à l’aide de l’algorithme spécifié dans l’attribut revisionsPassword dans [ISO/IEC-29500-1] section 18.2.29. Deuxièmement, cette chaîne est entrée dans l’algorithme d’obfuscation XOR spécifié dans la section [MS-OFFCRYPTO] section 2.3.7.1 pour produire une valeur de vérificateur de mot de passe 16 bits.

Cet attribut NE DOIT PAS être présent si algorithmName est présent.

algorithmName : Attribut ST_Xstring ([ISO/IEC-29500-1] section 22.9.2.19) qui spécifie le nom de l’algorithme de hachage utilisé pour calculer hashValue. Si cet attribut est présent, hashValue, saltValue et spinCount DOIVENT également être présents. Cet attribut NE DOIT PAS être présent si le mot de passe est présent.

hashValue : Attribut base64Binary ([XMLSCHEMA2] section 3.2.16) qui spécifie la valeur de hachage pour le mot de passe requis pour modifier cette plage. Cette valeur sera comparée à la valeur de hachage obtenue après le hachage du mot de passe fourni par l’utilisateur à l’aide de l’algorithme spécifié par algorithmName, et si les deux valeurs correspondent, la protection ne sera plus appliquée.

Les hachages de mot de passe sont calculés par l’algorithme spécifié dans [MS-OFFCRYPTO] section 2.4.2.4. Dans certains cas, le mot de passe est d’abord converti en une valeur de vérificateur 16 bits et réinterprété en tant que caractère Unicode unique, qui est ensuite transmis à l’algorithme spécifié dans la section [MS-OFFCRYPTO] section 2.4.2.4. Il n’existe aucun moyen de déterminer quelle méthode a été utilisée pour générer un hachage sans connaître le mot de passe ; il est nécessaire de calculer les deux hachages pour vérifier le mot de passe.

Cet attribut DOIT être présent si et uniquement si algorithmName est présent.

saltValue : Attribut base64Binary ([XMLSCHEMA2] section 3.2.16) qui spécifie le sel utilisé pour calculer hashValue. Cet attribut DOIT être présent si et uniquement si algorithmName est présent.

spinCount : Attribut unsignedInt ([XMLSCHEMA2] section 3.3.22) qui spécifie le nombre de fois où la fonction de hachage a été itérée sur le mot de passe pour générer le hashValue. ELLE NE DOIT PAS être supérieure à 10 000 000. Cet attribut DOIT être présent si et uniquement si algorithmName est présent.

nom: Attribut ST_Xstring ([ISO/IEC-29500-1] section 22.9.2.19) qui spécifie le titre de la plage de cellules. La valeur DOIT être unique pour la feuille (1). Le nombre de caractères dans la chaîne DOIT être supérieur ou égal à 1 et inférieur ou égal à 255. La chaîne DOIT être conforme à la grammaire ABNF (Augmented Backus-Naur Form) ([RFC5234]) suivante :

string = name-start-character *name-character

name-start-character = « _ » / « \ » / Unicode-character

name-character = name-start-character / Unicode-space / Unicode-digit / « ? » / « . »

Les points suivants résument cette grammaire :

Caractère Unicode est tout point de code qui est un caractère tel que défini par les propriétés de caractère Unicode, [UNICODE5.1] chapitre 4.

Unicode-digit est tout point de code qui est un chiffre tel que défini par les propriétés de caractère Unicode, [UNICODE5.1] chapitre 4.

Unicode-space est tout point de code qui est un espace tel que défini par les propriétés de caractère Unicode, [UNICODE5.1] chapitre 4.

securityDescriptor : Attribut de chaîne ([XMLSCHEMA2] section 3.2.1) qui spécifie un descripteur de sécurité ([MS-WSO] section 3.1.2.3.2) qui répertorie les utilisateurs qui peuvent modifier la plage de cellules sans fournir le mot de passe.

Le fragment de schéma XML W3C ([XMLSCHEMA1] section 2.1) suivant spécifie le contenu de ce type complexe.

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

Consultez la section 5.4 pour le schéma XML W3C complet ([XMLSCHEMA1] section 2.1).

Constructeurs

ProtectedRange()	Initialise une nouvelle instance de la classe ProtectedRange.
ProtectedRange(IEnumerable<OpenXmlElement>)	Initialise une nouvelle instance de la classe ProtectedRange avec les éléments enfants spécifiés.
ProtectedRange(OpenXmlElement[])	Initialise une nouvelle instance de la classe ProtectedRange avec les éléments enfants spécifiés.
ProtectedRange(String)	Initialise une nouvelle instance de la classe ProtectedRange à partir du code XML externe.

Propriétés

AlgorithmName	algorithmName, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : algorithmName
ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
Features	Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement)
FirstChild	Obtient le premier enfant de l’élément OpenXmlElement actuel. (Hérité de OpenXmlCompositeElement)
HasAttributes	Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement)
HasChildren	Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlCompositeElement)
HashValue	hashValue, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : hashValue
InnerText	Obtient ou définit les valeurs concaténées du nœud actuel et de tous ses enfants. (Hérité de OpenXmlCompositeElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les nœuds enfants du nœud actuel. (Hérité de OpenXmlCompositeElement)
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlCompositeElement)
LocalName	Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement)
MCAttributes	Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement)
Name	name, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : name
NamespaceDeclarations	Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement)
NamespaceUri	Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
OpenXmlElementContext	Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement)
OuterXml	Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement)
Parent	Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement)
Password	password, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : password
Prefix	Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
ReferenceSequence	ReferenceSequence. Représente la balise d’élément suivante dans le schéma : xne :sqref.
SaltValue	saltValue, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : saltValue
SecurityDescriptor	securityDescriptor, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : securityDescriptor
SpinCount	spinCount, cette propriété est disponible uniquement dans Office 2010 et versions ultérieures. Représente l’attribut suivant dans le schéma : spinCount
XmlQualifiedName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)
XName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)	Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Ajoute l’élément spécifié à l’élément s’il s’agit d’un enfant connu. Cela ajoute l’élément à l’emplacement approprié en fonction du schéma. (Hérité de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement)
Ancestors()	Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement)
Ancestors<T>()	Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
Annotation(Type)	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotation<T>()	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations(Type)	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations<T>()	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
Append(OpenXmlElement[])	Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
AppendChild<T>(T)	Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
ClearAllAttributes()	Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement)
Clone()	Crée un doublon du nœud actuel. (Hérité de OpenXmlElement)
CloneNode(Boolean)	Crée un doublon de ce nœud.
Descendants()	Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement)
Descendants<T>()	Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement)
Elements()	Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement)
Elements<T>()	Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
ElementsAfter()	Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
ElementsBefore()	Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
GetAttribute(String, String)	Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement)
GetAttributes()	Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement)
GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)
GetFirstChild<T>()	Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)	Insère l’élément spécifié à l’index spécifié des enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)	Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)	Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
LookupNamespace(String)	Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement)
LookupPrefix(String)	Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement)
NextSibling()	Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
NextSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
PrependChild<T>(T)	Insère l’élément spécifié au début de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
PreviousSibling()	Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
PreviousSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
Remove()	Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement)
RemoveAllChildren()	Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement)
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAnnotations<T>()	Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAttribute(String, String)	Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement)
RemoveChild<T>(T)	Supprime l’élément enfant spécifié. (Hérité de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Remplace l’un des éléments enfants de l’élément actuel par un autre élément OpenXmlElement. (Hérité de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
WriteTo(XmlWriter)	Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()	Définit la classe ProtectedRange. Cette classe est disponible dans Office 2010 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est x14 :protectedRange. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)