AssemblyInstaller.CheckIfInstallable メソッド

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

AssemblyInstaller.CheckIfInstallable メソッド

指定したアセンブリをインストールできるかどうかを確認します。

名前空間: System.Configuration.Install
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub CheckIfInstallable
 ( _
    assemblyName As String _
)

Visual Basic (使用法)

Dim assemblyName As String

AssemblyInstaller.CheckIfInstallable(assemblyName)

C#

public static void CheckIfInstallable
 (
    string assemblyName
)

C++

public:
static void CheckIfInstallable (
    String^ assemblyName
)

J#

public static void CheckIfInstallable
 (
    String assemblyName
)

JScript

public static function CheckIfInstallable
 (
    assemblyName : String
)

パラメータ

assemblyName

インストーラを検索する対象のアセンブリ。

例外

例外の種類	条件
Exception	指定したアセンブリをインストールできません。

解説

CheckIfInstallable メソッドは、指定したアセンブリをインストールできるかどうかを判断します。例外がスローされないようにするには、ファイルが次の基準を満たしている必要があります。

• ファイルが存在する。

• ファイルが .NET Framework アセンブリである。

• ファイルからパブリック型を読み取ることができる。

• Installer クラスを拡張する非抽象パブリック クラスが少なくとも 1 つ存在し、そのクラスに Yes 属性が格納されている。

• 各インストーラのインスタンスを作成できる。

メモ
アセンブリが有効であっても、インストーラが格納されていない場合は、例外がスローされます。この動作はインストール時の動作とは異なります。インストール時には、空のアセンブリをインストールしてもエラーにはなりません。

使用例

存在するアセンブリと存在しないアセンブリの両方に対して CheckIfInstallable メソッドを呼び出し、その結果をコンソールに表示する例を次に示します。

Visual Basic

Imports System
Imports System.Configuration.Install

Class MyCheckIfInstallableClass
   
   Shared Sub Main()

      Try
         ' Determine whether the assembly 'MyAssembly' is installable.
         AssemblyInstaller.CheckIfInstallable("MyAssembly_CheckIfInstallable.exe")
         
         Console.WriteLine("The assembly 'MyAssembly_CheckIfInstallable'
 is installable")
         
         ' Determine whether the assembly 'NonExistant' is installable.
         AssemblyInstaller.CheckIfInstallable("NonExistant")
       Catch 
      End Try

   End Sub 'Main

End Class 'MyCheckIfInstallableClass
 

C#

using System;
using System.Configuration.Install;



class MyCheckIfInstallableClass:Installer
{
   static void Main()
   {


      try
      {
         // Determine whether the assembly 'MyAssembly' is installable.
         AssemblyInstaller.CheckIfInstallable( "MyAssembly_CheckIfInstallable.exe"
 );

         Console.WriteLine( "The assembly 'MyAssembly_CheckIfInstallable' is
 installable" );

         // Determine whether the assembly 'NonExistant' is installable.
         AssemblyInstaller.CheckIfInstallable( "NonExistant" );
      }
      catch( Exception )
      {
      }


   }
}

C++

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
int main()
{
   try
   {
      
      // Determine whether the assembly 'MyAssembly' is installable.
      AssemblyInstaller::CheckIfInstallable( "MyAssembly_CheckIfInstallable.exe"
 );
      Console::WriteLine( "The assembly 'MyAssembly_CheckIfInstallable' is installable"
 );
      
      // Determine whether the assembly 'NonExistant' is installable.
      AssemblyInstaller::CheckIfInstallable( "NonExistant" );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e );
   }

}

J#

import System.*;
import System.Configuration.Install.*;

class MyCheckIfInstallableClass extends Installer
{
    public static void main(String[]
 args)
    {
        try {
            // Determine whether the assembly 'MyAssembly' is installable.
            AssemblyInstaller.CheckIfInstallable(
                "MyAssembly_CheckIfInstallable.exe");
            Console.WriteLine("The assembly 'MyAssembly_CheckIfInstallable'
 "
                + "is installable");

            // Determine whether the assembly 'NonExistant' is installable.
            AssemblyInstaller.CheckIfInstallable("NonExistant");
        }
        catch (System.Exception exp) {
        }
    } //main
} //MyCheckIfInstallableClass

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

参照

関連項目
AssemblyInstaller クラス
AssemblyInstaller メンバ
System.Configuration.Install 名前空間