Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ProtectedRange - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Définit le ProtectedRange Class.This classe n'est disponible dans Office2010 ou au-dessus. Lorsque l'objet est sérialisé en XML, son nom qualifié est x 14 : protectedRange.

Espace de noms :  DocumentFormat.OpenXml.Office2010.Excel
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

[OfficeAvailabilityAttribute(FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(ReferenceSequence))]
public class ProtectedRange : OpenXmlCompositeElement

2.6.56 CT_ProtectedRange

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

Référencé par : CT_ProtectedRanges

Un type complexe qui spécifie une plage de cellules pour être non protégée. La plage de cellules est modifiable avec un mot de passe ou bonne identification lors de la protection de la feuille (1) est activé et la cellule est verrouillée.

Éléments enfants

xm:sqref : Un élément sqref qui spécifie la plage de cellules pour être non protégée.

suivants :

mot de passe : Attribut ST_UnsignedShortHex ([ISO/IEC-29500-4] section 10.7.2) qui spécifie la valeur de vérificateur de mot de passe requis pour modifier la plage de cellules. Si la valeur est 0 x 0000, il n'existe aucun mot de passe.

La valeur de vérificateur est calculée en deux étapes. Tout d'abord, la chaîne de mot de passe Unicode fournie est convertie en une 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. En second lieu, cette chaîne est entrée dans l'algorithme d'obscurcissement XOR spécifié dans [MS-OFFCRYPTO] section 2.3.7.1 pour produire une valeur de vérificateur de mot de passe de 16 bits.

Cet attribut ne doit pas être présent si les 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 les hashValue. Si cet attribut est présent, hashValue, saltValueet spinCount doivent également être présents. Cet attribut ne doit pas être présent si le mot de passe est présent.

hashValue : Un base64Binary d' attribut (section [XMLSCHEMA2] 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 les algorithmName, et si les deux valeurs correspondent, la protection n'est 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 certaines circonstances, le mot de passe est tout d'abord converti en une valeur 16 bits vérificateur et réinterprétée comme un caractère Unicode unique, qui est ensuite transmis à l'algorithme spécifié dans [MS-OFFCRYPTO], section 2.4.2.4. Il n'y a aucun moyen de déterminer la méthode qui 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 seulement si les algorithmName est présent.

saltValue : Un base64Binary d' attribut (section [XMLSCHEMA2] 3.2.16) qui spécifie le sel permet de calculer hashValue. Cet attribut doit être présent si et seulement si les algorithmName est présent.

spinCount : Un entier non signé d' attribut (section [XMLSCHEMA2] 3.3.22) qui spécifie le nombre de fois où la fonction de hachage a été itérée au mot de passe pour générer hashValue. Il ne doit pas être supérieure à 10 000 000. Cet attribut doit être présent si et seulement si les 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érieure ou égale à 255. La chaîne doit se conformer à la grammaire suivante Augmentées Backus-Naur Form (ABNF) ([RFC5234]) :

chaîne = caractère de début de nom * caractère de nom

nom du caractère de début = « _ » / « \ » / caractères Unicode

caractère de nom = nom du caractère de début / Unicode-espace / Unicode-digit / "? « / »."

Les points suivants résument cette grammaire :

Unicode-caractère est n'importe quel point de code qui est un caractère, tel que défini par les propriétés de caractères Unicode,[UNICODE5.1]au chapitre 4.

Unicode chiffres est n'importe quel point de code qui est un chiffre comme défini par les propriétés de caractères Unicode,[UNICODE5.1]au chapitre 4.

Unicode-espace est n'importe quel point de code qui est un espace comme défini par les propriétés de caractères Unicode,[UNICODE5.1]au chapitre 4.

securityDescriptor : Une chaîne d' attribut (section [XMLSCHEMA2] 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 schéma XML W3C Suivant fragment ([XMLSCHEMA1] section 2.1) 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 >

< nom de le xsd:attribute = "password" type = "x: ST_UnsignedShortHex" utiliser = "optional" / >

< nom de xsd:attribute = "algorithmName" type = utiliser « x: ST_Xstring » = "optional" / >

< nom de le xsd:attribute = "hashValue" type = "xsd: base64Binary" utiliser = "optional" / >

< nom de le xsd:attribute = "saltValue" type = "xsd: base64Binary" utiliser = "optional" / >

< nom de le xsd:attribute = "spinCount" type = "xsd:unsignedInt" utiliser = "optional" / >

< nom de le xsd:attribute = "nom" type = "x: ST_Xstring" utiliser = "required" / >

< nom de le xsd:attribute = "securityDescriptor" type = "xsd: String" utiliser = "optional" / >

</xsd:complexType>

Consultez la section 5.4 de schéma XML W3C complète ([XMLSCHEMA1] section 2.1).

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: