FileVersionInfo

.NET Framework クラス ライブラリ リファレンス

FileVersionInfo クラス

ディスク上の物理ファイルのバージョン情報を提供します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 FileVersionInfo

Visual Basic (使用法)

Dim instance As FileVersionInfo

C#

public sealed class FileVersionInfo

C++

public ref class FileVersionInfo sealed

J#

public final class FileVersionInfo

JScript

public final class FileVersionInfo

解説

通常、バージョン番号は "メジャー番号.マイナ番号.ビルド番号.プライベート パート番号" の形式で表示されます。ファイル バージョン番号は、ファイルのバージョン番号を示す 64 ビットの数値であり、次のような構成になっています。

• 最初の 16 ビット値は、FileMajorPart 番号です。

• 2 番目の 16 ビット値は、FileMinorPart 番号です。

• 3 番目の 16 ビット値は、FileBuildPart 番号です。

• 最後の 16 ビット値は、FilePrivatePart 番号です。

ファイルに関する情報を含む FileVersionInfo を取得するには、このクラスの GetVersionInfo メソッドを使用して、プロパティでファイルの情報を参照します。FileVersion プロパティは、ファイルに関するバージョン情報を提供します。ProductMajorPart、ProductMinorPart、ProductBuildPart、ProductPrivatePart、ProductVersion の各プロパティは、指定したファイルを含む製品のバージョン情報を提供します。このファイルのプロパティの部分リストとその値を取得するには ToString を呼び出します。

FileVersionInfo プロパティは、ファイルに組み込まれたバージョン リソース情報に基づいています。バージョン リソースは、多くの場合、.exe や .dll などのバイナリ ファイルに組み込まれています。テキスト ファイルにはバージョン リソース情報は含まれていません。

バージョン リソースは、通常、Win32 リソース ファイル内、またはアセンブリ 属性内で指定されています。たとえば IsDebug プロパティは、Win32 リソース ファイル内の VERSIONINFO リソースから組み込まれる、ファイルの VS_FIXEDFILEINFO ブロックの VS_FF_DEBUG フラグ値を反映します。Win32 リソース ファイルでバージョン リソースを指定する方法の詳細については、プラットフォーム SDK の「About Resource Files」および「VERSIONINFO Resource」を参照してください。.NET モジュール内のバージョン リソース ファイルの指定の詳細については、「アセンブリ属性の設定」トピックを参照してください。

メモ
このクラスは、すべてのメンバに適用されるリンク確認要求をクラス レベルで行います。直前の呼び出し元に完全信頼のアクセス許可がない場合は、SecurityException がスローされます。リンク確認要求の詳細については、「リンク確認要求」を参照してください。

使用例

GetVersionInfo を呼び出して、メモ帳の FileVersionInfo を取得する例を次に示します。次に、ファイルの説明とバージョン番号をテキスト ボックスに出力します。このコードは、textBox1 がインスタンス化されていることを前提にしています。

Visual Basic

Sub GetFileVersion()
    ' Get the file version for the notepad.
    Dim myFileVersionInfo As FileVersionInfo
 = FileVersionInfo.GetVersionInfo("%systemroot%\Notepad.exe")
    
    ' Print the file name and version number.
    textBox1.Text = "File: " & myFileVersionInfo.FileDescription
 & ControlChars.Cr & _
        "Version number: " & myFileVersionInfo.FileVersion
End Sub 'GetFileVersion

C#

public void GetFileVersion() {
    // Get the file version for the notepad.
    FileVersionInfo myFileVersionInfo = FileVersionInfo.GetVersionInfo("%systemroot%\\Notepad.exe");
 
    // Print the file name and version number.
    textBox1.Text = "File: " + myFileVersionInfo.FileDescription + '\n'
 +
       "Version number: " + myFileVersionInfo.FileVersion;
 }
    

C++

public:
   [PermissionSet(SecurityAction::Demand, Name="FullTrust")]
   void GetFileVersion()
   {
      // Get the file version for the notepad.
      FileVersionInfo^ myFileVersionInfo = FileVersionInfo::GetVersionInfo( "%systemroot%\\Notepad.exe"
 );
      
      // Print the file name and version number.
      textBox1->Text = String::Concat( "File: " + myFileVersionInfo->FileDescription
 + "\n" +
         "Version number: " + myFileVersionInfo->FileVersion );
   }

.NET Framework のセキュリティ

• SecurityPermission  (FileVersionInfo のメンバを呼び出すためのアクセス許可)要求値 : LinkDemand、名前付きアクセス許可セット、FullTrust。

継承階層

System.Object
  System.Diagnostics.FileVersionInfo

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FileVersionInfo メンバ
System.Diagnostics 名前空間
FileVersion
Version

FileVersionInfo プロパティ

パブリック プロパティ

	名前	説明
	Comments	ファイルに関連付けられているコメントを取得します。
	CompanyName	ファイルを作成した会社名を取得します。
	FileBuildPart	ファイルのビルド番号を取得します。
	FileDescription	ファイルの説明を取得します。
	FileMajorPart	メジャー バージョン番号を取得します。
	FileMinorPart	マイナ バージョン番号を取得します。
	FileName	FileVersionInfo のこのインスタンスが記述するファイル名を取得します。
	FilePrivatePart	ファイルのプライベート パート番号を取得します。
	FileVersion	ファイルのバージョン番号を取得します。
	InternalName	ファイルの内部名がある場合には、内部名を取得します。
	IsDebug	ファイルにデバッグ情報を格納するか、またはデバッグ機能を有効にしてファイルをコンパイルするかを指定する値を取得します。
	IsPatched	ファイルが変更されているかどうか、および同じバージョン番号の出荷時の元のファイルと異なっているかどうかを指定する値を取得します。
	IsPreRelease	ファイルが市販バージョンではない開発用バージョンかどうかを指定する値を取得します。
	IsPrivateBuild	ファイルが標準リリース プロシージャで作成されたかどうかを指定する値を取得します。
	IsSpecialBuild	ファイルが特殊なビルドかどうかを指定する値を取得します。
	Language	バージョン情報ブロックの既定の言語識別文字列を取得します。
	LegalCopyright	指定されたファイルに適用される著作権表記を取得します。
	LegalTrademarks	ファイルに適用される商標と登録商標を取得します。
	OriginalFilename	ファイルが作成されたときの名前を取得します。
	PrivateBuild	ファイルのプライベート バージョン情報を取得します。
	ProductBuildPart	このファイルに関連付けられている製品のビルド番号を取得します。
	ProductMajorPart	このファイルに関連付けられている製品のメジャー バージョン番号を取得します。
	ProductMinorPart	このファイルに関連付けられている製品のマイナ バージョン番号を取得します。
	ProductName	このファイルを含む製品の名前を取得します。
	ProductPrivatePart	このファイルに関連付けられている製品のプライベート パート番号を取得します。
	ProductVersion	このファイルを含む製品のバージョンを取得します。
	SpecialBuild	ファイルの特殊ビルド情報を取得します。

参照

関連項目

FileVersionInfo クラス
System.Diagnostics 名前空間
FileVersion
Version

FileVersionInfo メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetVersionInfo	指定されたファイルに関連付けられているバージョン情報を表す FileVersionInfo を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 FileVersionInfo のプロパティの部分リストとその値を返します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

FileVersionInfo クラス
System.Diagnostics 名前空間
FileVersion
Version

FileVersionInfo メンバ

ディスク上の物理ファイルのバージョン情報を提供します。

FileVersionInfo データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	Comments	ファイルに関連付けられているコメントを取得します。
	CompanyName	ファイルを作成した会社名を取得します。
	FileBuildPart	ファイルのビルド番号を取得します。
	FileDescription	ファイルの説明を取得します。
	FileMajorPart	メジャー バージョン番号を取得します。
	FileMinorPart	マイナ バージョン番号を取得します。
	FileName	FileVersionInfo のこのインスタンスが記述するファイル名を取得します。
	FilePrivatePart	ファイルのプライベート パート番号を取得します。
	FileVersion	ファイルのバージョン番号を取得します。
	InternalName	ファイルの内部名がある場合には、内部名を取得します。
	IsDebug	ファイルにデバッグ情報を格納するか、またはデバッグ機能を有効にしてファイルをコンパイルするかを指定する値を取得します。
	IsPatched	ファイルが変更されているかどうか、および同じバージョン番号の出荷時の元のファイルと異なっているかどうかを指定する値を取得します。
	IsPreRelease	ファイルが市販バージョンではない開発用バージョンかどうかを指定する値を取得します。
	IsPrivateBuild	ファイルが標準リリース プロシージャで作成されたかどうかを指定する値を取得します。
	IsSpecialBuild	ファイルが特殊なビルドかどうかを指定する値を取得します。
	Language	バージョン情報ブロックの既定の言語識別文字列を取得します。
	LegalCopyright	指定されたファイルに適用される著作権表記を取得します。
	LegalTrademarks	ファイルに適用される商標と登録商標を取得します。
	OriginalFilename	ファイルが作成されたときの名前を取得します。
	PrivateBuild	ファイルのプライベート バージョン情報を取得します。
	ProductBuildPart	このファイルに関連付けられている製品のビルド番号を取得します。
	ProductMajorPart	このファイルに関連付けられている製品のメジャー バージョン番号を取得します。
	ProductMinorPart	このファイルに関連付けられている製品のマイナ バージョン番号を取得します。
	ProductName	このファイルを含む製品の名前を取得します。
	ProductPrivatePart	このファイルに関連付けられている製品のプライベート パート番号を取得します。
	ProductVersion	このファイルを含む製品のバージョンを取得します。
	SpecialBuild	ファイルの特殊ビルド情報を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetVersionInfo	指定されたファイルに関連付けられているバージョン情報を表す FileVersionInfo を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 FileVersionInfo のプロパティの部分リストとその値を返します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

FileVersionInfo クラス
System.Diagnostics 名前空間
FileVersion
Version