ProtectedRange クラス

定義

名前空間:

DocumentFormat.OpenXml.Office2010.Excel

アセンブリ:

DocumentFormat.OpenXml.dll

パッケージ:

DocumentFormat.OpenXml v3.0.1

ProtectedRange クラスを定義します。

このクラスは、Office 2010 以降で使用できます。

オブジェクトを xml としてシリアル化されるときに、修飾名は x14:protectedRange です。

public class ProtectedRange : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ProtectedRange = class
    inherit OpenXmlCompositeElement

Public Class ProtectedRange
Inherits OpenXmlCompositeElement

継承

Object

OpenXmlElement

OpenXmlCompositeElement

ProtectedRange

注釈

2.6.56 CT_ProtectedRange

ターゲット名前空間:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

参照先: CT_ProtectedRanges

保護されていないセル範囲を指定する複合型。 シート (1) 保護がオンでセルがロックされている場合、セル範囲はパスワードまたは適切な資格情報で編集できます。

子要素:

xm:sqref: 保護解除するセル範囲を指定する sqref 要素。

属性：

パスワード： セル範囲の編集に必要なパスワードの検証ツール値を指定する ST_UnsignedShortHex ([ISO/IEC-29500-4] セクション 10.7.2) 属性。 値が0x0000の場合、パスワードはありません。

検証ツールの値は、2 つの段階で計算されます。 最初に、指定された Unicode パスワード文字列は、[ISO/IEC-29500-1] セクション 18.2.29 の revisionsPassword 属性で指定されたアルゴリズムを使用して、現在のシステムの ANSI コード ページの新しい文字文字列に変換されます。 次に、[MS-OFFCRYPTO] セクション 2.3.7.1 で指定された XOR 難読化 アルゴリズムにこの文字列が入力され、16 ビットのパスワード検証ツール値が生成されます。

algorithmName が存在する場合、この属性は存在しない必要があります。

algorithmName:hashValue の計算に使用されるハッシュ アルゴリズムの名前を指定するST_Xstring ([ISO/IEC-29500-1] セクション 22.9.2.19) 属性。 この属性が存在する場合は、 hashValue、 saltValue、 spinCount も存在する必要があります。 パスワードが存在する場合、この属性は存在しない必要があります。

hashValue: この範囲の編集に必要なパスワードのハッシュ値を指定する base64Binary ([XMLSCHEMA2] セクション 3.2.16) 属性。 この値は、 algorithmName で指定されたアルゴリズムを使用してユーザー指定のパスワードをハッシュした後、結果のハッシュ値と比較され、2 つの値が一致する場合、保護は適用されなくなります。

パスワード ハッシュは、[MS-OFFCRYPTO] セクション 2.4.2.4 で指定されたアルゴリズムによって計算されます。 状況によっては、パスワードは最初に 16 ビットの検証ツールの値に変換され、1 つの Unicode 文字として再解釈され、[MS-OFFCRYPTO] セクション 2.4.2.4 で指定されたアルゴリズムに渡されます。 パスワードを知らなくてもハッシュを生成するために使用されたメソッドを特定する方法はありません。パスワードを確認するには、両方のハッシュを計算する必要があります。

algorithmName が存在する場合にのみ、この属性が存在する必要があります。

saltValue:hashValue の計算に使用されるソルトを指定する base64Binary ([XMLSCHEMA2] セクション 3.2.16) 属性。 algorithmName が存在する場合にのみ、この属性が存在する必要があります。

spinCount:unsignedInt ([XMLSCHEMA2] セクション 3.3.22) 属性。ハッシュ関数がパスワードを反復処理して hashValue を生成した回数を指定します。 10,000,000 を超えてはなりません。 algorithmName が存在する場合にのみ、この属性が存在する必要があります。

名前： セル範囲のタイトルを指定する ST_Xstring ([ISO/IEC-29500-1] セクション 22.9.2.19) 属性。 値は、シートに対して一意である必要があります (1)。 文字列内の文字数は、1 以上、255 以下である必要があります。 文字列は、次の 拡張 Backus-Naur フォーム (ABNF) ( [RFC5234]) 文法に準拠している必要があります。

string = name-start-character *name-character

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

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

この文法の概要を次に示します。

§Unicode 文字は、Unicode 文字プロパティ [UNICODE5.1] 第 4 章で定義されている文字である任意のコード ポイントです。

§Unicode-digit は、Unicode 文字プロパティ [UNICODE5.1] 第 4 章で定義されている数字である任意のコード ポイントです。

§Unicode-space は、Unicode 文字プロパティ [UNICODE5.1] 第 4 章で定義されているスペースである任意のコード ポイントです。

securityDescriptor:パスワードを指定せずにセル範囲を編集できるユーザーを一覧表示するセキュリティ記述子 ([MS-WSO] セクション 3.1.2.3.2) を指定する文字列 ([XMLSCHEMA2] セクション 3.2.1) 属性。

次の W3C XML スキーマ ([XMLSCHEMA1] セクション 2.1) フラグメントは、この複合型の内容を指定します。

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

完全な W3C XML スキーマについては、セクション 5.4 を参照してください ([XMLSCHEMA1] セクション 2.1)。

コンストラクター

ProtectedRange()	ProtectedRange クラスの新しいインスタンスを初期化します。
ProtectedRange(IEnumerable<OpenXmlElement>)	指定した子要素を使用して、ProtectedRange クラスの新しいインスタンスを初期化します。
ProtectedRange(OpenXmlElement[])	指定した子要素を使用して、ProtectedRange クラスの新しいインスタンスを初期化します。
ProtectedRange(String)	外部 XML から ProtectedRange クラスの新しいインスタンスを初期化します。

プロパティ

AlgorithmName	algorithmName、このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します: algorithmName
ChildElements	現在の要素のすべての子ノードを取得します。 (継承元 OpenXmlElement)
ExtendedAttributes	現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。 (継承元 OpenXmlElement)
Features	現在の要素の を IFeatureCollection 取得します。 この機能コレクションは読み取り専用ですが、使用可能な場合は親パーツとパッケージから機能を継承します。 (継承元 OpenXmlElement)
FirstChild	現在の OpenXmlElement 要素の最初の子を取得します。 (継承元 OpenXmlCompositeElement)
HasAttributes	現在の要素に属性があるかどうかを示す値を取得します。 (継承元 OpenXmlElement)
HasChildren	現在の要素に子要素があるかどうかを示す値を取得します。 (継承元 OpenXmlCompositeElement)
HashValue	hashValue、このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します: hashValue
InnerText	現在のノードとそのすべての子の連結値を取得または設定します。 (継承元 OpenXmlCompositeElement)
InnerXml	現在のノードの子ノードのみを表すマークアップを取得または設定します。 (継承元 OpenXmlCompositeElement)
LastChild	現在の OpenXmlElement 要素の最後の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlCompositeElement)
LocalName	現在の要素のローカル名を取得します。 (継承元 OpenXmlElement)
MCAttributes	マークアップ互換性属性を取得または設定します。 現在の要素に対してマークアップ互換性属性が定義されていない場合は null を返します。 (継承元 OpenXmlElement)
Name	name、 このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します。
NamespaceDeclarations	現在の要素で定義されているすべての名前空間宣言を取得します。 名前空間宣言がない場合は、空の列挙子を返します。 (継承元 OpenXmlElement)
NamespaceUri	現在の要素の名前空間 URI を取得します。 (継承元 OpenXmlElement)
OpenXmlElementContext	現在の要素の OpenXmlElementContext を取得します。 (継承元 OpenXmlElement)
OuterXml	現在の要素とそのすべての子要素を表すマークアップを取得します。 (継承元 OpenXmlElement)
Parent	現在の要素の親要素を取得します。 (継承元 OpenXmlElement)
Password	パスワードの場合、このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します: password
Prefix	現在の要素の名前空間プレフィックスを取得します。 (継承元 OpenXmlElement)
ReferenceSequence	ReferenceSequence。 スキーマ内の次の要素タグを表します: xne:sqref。
SaltValue	saltValue、このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します。 saltValue
SecurityDescriptor	securityDescriptor、このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します。 securityDescriptor
SpinCount	spinCount、このプロパティは Office 2010 以降でのみ使用できます。 スキーマ内の次の属性を表します: spinCount
XmlQualifiedName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)
XName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)

メソッド

AddAnnotation(Object)	現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。 (継承元 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	指定した要素が既知の子である場合は、 要素に追加します。 これにより、 要素がスキーマに従って正しい場所に追加されます。 (継承元 OpenXmlCompositeElement)
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)	現在の要素の子ノードのリストの末尾に、指定した要素を追加します。 (継承元 OpenXmlCompositeElement)
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)	指定した参照要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	現在の要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAt<T>(T, Int32)	現在の要素の子の指定したインデックス位置に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	指定した参照要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
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)	現在の要素の子ノードのリストの先頭に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
PreviousSibling()	現在の OpenXmlElement 要素のすぐ前にある OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PreviousSibling<T>()	現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
Remove()	現在の要素を親から削除します。 (継承元 OpenXmlElement)
RemoveAllChildren()	現在の要素のすべての子要素を削除します。 (継承元 OpenXmlCompositeElement)
RemoveAllChildren<T>()	T 型の現在の要素の子要素をすべて削除します。 (継承元 OpenXmlElement)
RemoveAnnotations(Type)	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAnnotations<T>()	指定した型の注釈を現在の OpenXmlElement 要素から削除します。 (継承元 OpenXmlElement)
RemoveAttribute(String, String)	現在の要素から 属性を削除します。 (継承元 OpenXmlElement)
RemoveChild<T>(T)	指定した子要素を削除します。 (継承元 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	指定したプレフィックスの名前空間宣言を削除します。 プレフィックスがない場合は、何も削除しません。 (継承元 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	現在の要素の子要素の 1 つを別の OpenXmlElement 要素に置き換えます。 (継承元 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	指定した要素に属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	要素に複数の属性を設定します。 属性が既知の属性の場合、属性の値が設定されます。 属性が拡張属性の場合は、拡張属性リストに 'openxmlAttribute' が追加されます。 (継承元 OpenXmlElement)
WriteTo(XmlWriter)	現在のノードを指定した XmlWriter に保存します。 (継承元 OpenXmlElement)

明示的なインターフェイスの実装

IEnumerable.GetEnumerator()	ProtectedRange クラスを定義します。 このクラスは、Office 2010 以降で使用できます。 オブジェクトを xml としてシリアル化されるときに、修飾名は x14:protectedRange です。 (継承元 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	子コレクションを反復処理する列挙子を返します。 (継承元 OpenXmlElement)