ホーム › Storage.Packaging.Opc › OPC_READ_FLAGS

OPC_READ_FLAGS

列挙型フラグ

📘 Microsoft Learn (日本語) · English

基底型i4

メンバー 3

名前	10進	16進	説明
OPC_READ_DEFAULT	0	0x0	パッケージコンポーネントにアクセスするときに、そのコンポーネントを OPC の適合要件に照らして検証します。OPC の適合検証の詳細については、「解説」を参照してください。アクセス時に検証が実行される場合、OPC の検証エラーはいずれのメソッドからも返される可能性があります。
OPC_VALIDATE_ON_LOAD	1	0x1	パッケージの読み込み時に、すべてのパッケージコンポーネントを OPC の適合要件に照らして検証します。OPC の適合検証の詳細については、「解説」を参照してください。この設定を有効にした場合、パッケージコンポーネントの読み込みと検証にかかるパフォーマンスコストは、パッケージが最初に読み込まれるときに発生します。
OPC_CACHE_ON_ACCESS	2	0x2	パッケージコンポーネントに初めてアクセスするときに、展開されたコンポーネントのデータを一時ファイルとしてキャッシュします。パッケージコンポーネントに繰り返しアクセスする場合、コンポーネントのデータは読み取り操作のたびではなく最初の読み取り時に一度だけ展開されるため、このキャッシュによってオーバーヘッドが軽減されます。

名前

10進

16進

説明

OPC_READ_DEFAULT

0x0

パッケージコンポーネントにアクセスするときに、そのコンポーネントを OPC の適合要件に照らして検証します。OPC の適合検証の詳細については、「解説」を参照してください。

アクセス時に検証が実行される場合、OPC の検証エラーはいずれのメソッドからも返される可能性があります。

OPC_VALIDATE_ON_LOAD

0x1

パッケージの読み込み時に、すべてのパッケージコンポーネントを OPC の適合要件に照らして検証します。OPC の適合検証の詳細については、「解説」を参照してください。

この設定を有効にした場合、パッケージコンポーネントの読み込みと検証にかかるパフォーマンスコストは、パッケージが最初に読み込まれるときに発生します。

OPC_CACHE_ON_ACCESS

0x2

パッケージコンポーネントに初めてアクセスするときに、展開されたコンポーネントのデータを一時ファイルとしてキャッシュします。パッケージコンポーネントに繰り返しアクセスする場合、コンポーネントのデータは読み取り操作のたびではなく最初の読み取り時に一度だけ展開されるため、このキャッシュによってオーバーヘッドが軽減されます。

公式ドキュメント

パッケージコンポーネントをキャッシュし、ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC) の適合要件に照らして検証するための読み取り設定を示します。

解説(Remarks)

OPC_CACHE_ON_ACCESS と OPC_VALIDATE_ON_LOAD の両方の読み取りフラグが設定されている場合、パッケージの読み込み時にすべてのパッケージコンポーネントが展開されてキャッシュされます。

Packaging API は OPC のコアプロパティ機能を使用しません。そのため、OPC の表 H-9 に記載されているコアプロパティの要件は、Packaging API では検証されません。OPC の適合要件の詳細については、ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/) の 1st edition, Part 2: Open Packaging Conventions を参照してください。

重要どの読み取りフラグが設定されているかにかかわらず、パーツはいつでもストリームから繰り返し読み取られる可能性があります。たとえば、パッケージの保存時に、マークアップの互換性を維持するために、元のパッケージの Relationships パート内で以前にアクセスされたリレーションシップが再度アクセスされることがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum OPC_READ_FLAGS : int {
    OPC_READ_DEFAULT = 0,
    OPC_VALIDATE_ON_LOAD = 1,
    OPC_CACHE_ON_ACCESS = 2
} OPC_READ_FLAGS;

[Flags]
public enum OPC_READ_FLAGS : int
{
    OPC_READ_DEFAULT = 0,
    OPC_VALIDATE_ON_LOAD = 1,
    OPC_CACHE_ON_ACCESS = 2,
}

<Flags>
Public Enum OPC_READ_FLAGS As Integer
    OPC_READ_DEFAULT = 0
    OPC_VALIDATE_ON_LOAD = 1
    OPC_CACHE_ON_ACCESS = 2
End Enum

import enum

class OPC_READ_FLAGS(enum.IntFlag):
    OPC_READ_DEFAULT = 0
    OPC_VALIDATE_ON_LOAD = 1
    OPC_CACHE_ON_ACCESS = 2

// OPC_READ_FLAGS (flags)
pub const OPC_READ_DEFAULT: i32 = 0;
pub const OPC_VALIDATE_ON_LOAD: i32 = 1;
pub const OPC_CACHE_ON_ACCESS: i32 = 2;

// OPC_READ_FLAGS
const (
	OPC_READ_DEFAULT int32 = 0
	OPC_VALIDATE_ON_LOAD int32 = 1
	OPC_CACHE_ON_ACCESS int32 = 2
)

const
  OPC_READ_DEFAULT = 0;
  OPC_VALIDATE_ON_LOAD = 1;
  OPC_CACHE_ON_ACCESS = 2;

// OPC_READ_FLAGS
pub const OPC_READ_DEFAULT: i32 = 0;
pub const OPC_VALIDATE_ON_LOAD: i32 = 1;
pub const OPC_CACHE_ON_ACCESS: i32 = 2;

const
  OPC_READ_DEFAULT* = 0
  OPC_VALIDATE_ON_LOAD* = 1
  OPC_CACHE_ON_ACCESS* = 2

enum OPC_READ_FLAGS : int {
    OPC_READ_DEFAULT = 0,
    OPC_VALIDATE_ON_LOAD = 1,
    OPC_CACHE_ON_ACCESS = 2,
}

#define global OPC_READ_DEFAULT     0x0
#define global OPC_VALIDATE_ON_LOAD 0x1
#define global OPC_CACHE_ON_ACCESS  0x2
; ※フラグ列挙型。ビットORで組み合わせ可(例: FOO|BAR)。