RegistrationErrorInfo

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

RegistrationErrorInfo クラス

複数の COM+ オブジェクトに関連するメソッドについての拡張エラー情報を取得します。これには COM+ アプリケーションおよび COM+ コンポーネントをインストール、インポート、およびエクスポートするメソッドも含まれます。このクラスは継承できません。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 RegistrationErrorInfo

Visual Basic (使用法)

Dim instance As RegistrationErrorInfo

C#

[SerializableAttribute] 
public sealed class RegistrationErrorInfo

C++

[SerializableAttribute] 
public ref class RegistrationErrorInfo sealed

J#

/** @attribute SerializableAttribute() */ 
public final class RegistrationErrorInfo

JScript

SerializableAttribute 
public final class RegistrationErrorInfo

使用例

複数の COM+ オブジェクトに関連するメソッドについての拡張エラー情報を取得する方法を次のコード例に示します。

Visual Basic

Try
    Dim applicationName As String
 = "Queued Component"
    Dim typeLibraryName As String
 = Nothing
    Dim helper As New RegistrationHelper

    ' Call the InstallAssembly method passing it the name of the assembly
 to 
    ' install as a COM+ application, the COM+ application name, and
 
    ' the name of the type library file.
    ' Setting the application name and the type library to NULL (nothing
 in Visual Basic .NET
    ' allows you to use the COM+ application name that is given in the
 assembly and 
    ' the default type library name. The application name in the assembly
 metadata 
    ' takes precedence over the application name you provide to InstallAssembly.
 
    helper.InstallAssembly("C:..\..\QueuedComponent.dll",
 applicationName, typeLibraryName, InstallationFlags.CreateTargetApplication)
    MsgBox("Registration succeeded: Type library "
 & typeLibraryName & " created.")
    Console.Read()

    ' Create a RegistrationConfig object and set its attributes
    ' Create a RegistrationHelper object, and call the InstallAssemblyFromConfig
    ' method by passing the RegistrationConfiguration object to it as
 a 
    ' reference object
    Dim registrationConfiguration As New
 RegistrationConfig()
    registrationConfiguration.AssemblyFile = "C:..\..\QueuedComponent.dll"
    registrationConfiguration.Application = "MyApp"
    registrationConfiguration.InstallationFlags = InstallationFlags.CreateTargetApplication
    Dim helperFromConfig As New
 RegistrationHelper()
    helperFromConfig.InstallAssemblyFromConfig(registrationConfiguration)

Catch e As RegistrationException
    MsgBox(e.Message)

    ' Check whether the ErrorInfo property of the RegistrationException
 object is null. 
    ' If there is no extended error information about 
    ' methods related to multiple COM+ objects ErrorInfo will be null.
    If Not (e.ErrorInfo Is
 Nothing) Then
        ' Gets an array of RegistrationErrorInfo objects describing
 registration errors
        Dim registrationErrorInfos As RegistrationErrorInfo()
 = e.ErrorInfo

        ' Iterate through the array of RegistrationErrorInfo objects
 and disply the 
        ' ErrorString for each object.
        Dim registrationErrorInfo As RegistrationErrorInfo
        For Each registrationErrorInfo In
 registrationErrorInfos
            MsgBox(registrationErrorInfo.ErrorString)
        Next registrationErrorInfo
    End If
    Console.Read()
End Try

C#

try
{
    string applicationName = "Queued Component";   
         
    string typeLibraryName = null;
    RegistrationHelper helper = new RegistrationHelper(); 
    // Call the InstallAssembly method passing it the name of the assembly
 to 
    // install as a COM+ application, the COM+ application name, and
 
    // the name of the type library file.
    // Setting the application name and the type library to NULL (nothing
 in Visual Basic .NET
    // allows you to use the COM+ application name that is given in
 the assembly and 
    // the default type library name. The application name in the assembly
 metadata 
    // takes precedence over the application name you provide to InstallAssembly.
 
    helper.InstallAssembly(@"C:..\..\QueuedComponent.dll", ref applicationName,
 ref typeLibraryName, InstallationFlags.CreateTargetApplication);
    Console.WriteLine("Registration succeeded: Type library {0} created.",
 typeLibraryName);
    Console.Read();

    // Create a RegistrationConfig object and set its attributes
    // Create a RegistrationHelper object, and call the InstallAssemblyFromConfig
    // method by passing the RegistrationConfiguration object to it
 as a 
    // reference object
    RegistrationConfig registrationConfiguration = new RegistrationConfig();
    registrationConfiguration.AssemblyFile=@"C:..\..\QueuedComponent.dll";
    registrationConfiguration.Application = "MyApp";
    registrationConfiguration.InstallationFlags = InstallationFlags.CreateTargetApplication;
    RegistrationHelper helperFromConfig = new RegistrationHelper();
    helperFromConfig.InstallAssemblyFromConfig(ref registrationConfiguration); 
                
}

catch(RegistrationException e)
{
    Console.WriteLine(e.Message); 
    
    // Check whether the ErrorInfo property of the RegistrationException
 object is null. 
    // If there is no extended error information about 
    // methods related to multiple COM+ objects ErrorInfo will be null.
    if(e.ErrorInfo != null)
    {
        // Gets an array of RegistrationErrorInfo objects describing
 registration errors
        RegistrationErrorInfo[] registrationErrorInfos = e.ErrorInfo;
        
        // Iterate through the array of RegistrationErrorInfo objects
 and disply the 
        // ErrorString for each object.

        foreach (RegistrationErrorInfo registrationErrorInfo in
 registrationErrorInfos) 
        {
            Console.WriteLine(registrationErrorInfo.ErrorString);
        }
    }
    Console.Read();
}

C++

try
{
   String^ applicationName = "Queued Component";
   String^ typeLibraryName = nullptr;
   RegistrationHelper^ helper = gcnew RegistrationHelper;
   // Call the InstallAssembly method passing it the name of the assembly
 to 
   // install as a COM+ application, the COM+ application name, and
 
   // the name of the type library file.
   // Setting the application name and the type library to NULL (nothing
 in Visual Basic .NET
   // allows you to use the COM+ application name that is given in the
 assembly and 
   // the default type library name. The application name in the assembly
 metadata 
   // takes precedence over the application name you provide to InstallAssembly.
 
   helper->InstallAssembly( "C:..\\..\\QueuedComponent.dll",  applicationName,
  typeLibraryName, InstallationFlags::CreateTargetApplication );
   Console::WriteLine( "Registration succeeded: Type library {0} created.",
 typeLibraryName );
   Console::Read();

   // Create a RegistrationConfig object and set its attributes
   // Create a RegistrationHelper object, and call the InstallAssemblyFromConfig
   // method by passing the RegistrationConfiguration object to it as
 a 
   // reference object
   RegistrationConfig^ registrationConfiguration = gcnew RegistrationConfig;
   registrationConfiguration->AssemblyFile = "C:..\\..\\QueuedComponent.dll";
   registrationConfiguration->Application = "MyApp";
   registrationConfiguration->InstallationFlags = InstallationFlags::CreateTargetApplication;
   RegistrationHelper^ helperFromConfig = gcnew RegistrationHelper;
   helperFromConfig->InstallAssemblyFromConfig(  registrationConfiguration );
}
catch ( RegistrationException^ e ) 
{
   Console::WriteLine( e->Message );

   // Check whether the ErrorInfo property of the RegistrationException
 object is null. 
   // If there is no extended error information about 
   // methods related to multiple COM+ objects ErrorInfo will be null.
   if ( e->ErrorInfo != nullptr )
   {
      // Gets an array of RegistrationErrorInfo objects describing registration
 errors
      array<RegistrationErrorInfo^>^ registrationErrorInfos = e->ErrorInfo;
      
      // Iterate through the array of RegistrationErrorInfo objects
 and disply the 
      // ErrorString for each object.
      System::Collections::IEnumerator^ myEnum = registrationErrorInfos->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         RegistrationErrorInfo^ registrationErrorInfo = (RegistrationErrorInfo^)(
 myEnum->Current );
         Console::WriteLine( registrationErrorInfo->ErrorString );
      }
   }
   Console::Read();
}

J#

try {
    String applicationName = "Queued Component";
    String typeLibraryName = null;
    RegistrationHelper helper = new RegistrationHelper();
    // Call the InstallAssembly method passing it the 
    // name of the assembly to install as a COM+ application, 
    // the COM+ application name, and the name of the type library file.
    // Setting the application name and the type library to NULL 
    // (nothing in Visual Basic .NET allows you to use the COM+ 
    // application name that is given in the assembly and the default
    // type library name. The application name in the assembly metadata
 
    // takes precedence over the application name you provide to 
    // InstallAssembly. 
    helper.InstallAssembly("C:..\\..\\QueuedComponent.dll", 
        applicationName, typeLibraryName, 
        InstallationFlags.CreateTargetApplication);
    Console.WriteLine("Registration succeeded: Type library {0} created.",
 
        typeLibraryName);
    Console.Read();

    // Create a RegistrationConfig object and set its attributes
    // Create a RegistrationHelper object, and call the 
    // InstallAssemblyFromConfig method by passing the 
    // RegistrationConfiguration object to it as a reference object
    RegistrationConfig registrationConfiguration = 
        new RegistrationConfig();
    registrationConfiguration.set_AssemblyFile(
        "C:..\\..\\QueuedComponent.dll");
    registrationConfiguration.set_Application("MyApp");
    registrationConfiguration.set_InstallationFlags(InstallationFlags.
        CreateTargetApplication);
    RegistrationHelper helperFromConfig = new RegistrationHelper();
    helperFromConfig.InstallAssemblyFromConfig(registrationConfiguration);
}
catch (RegistrationException e) {
    Console.WriteLine(e.get_Message());

    // Check whether the ErrorInfo property of the RegistrationException
    // object is null. If there is no extended error information about
 
    // methods related to multiple COM+ objects ErrorInfo will be null.
    if (e.get_ErrorInfo() != null) {
        // Gets an array of RegistrationErrorInfo objects describing
 
        // registration errors
        RegistrationErrorInfo registrationErrorInfos[] 
            = e.get_ErrorInfo();
        // Iterate through the array of RegistrationErrorInfo 
        // objects and disply the ErrorString for each object.
        for (int iCtr = 0; iCtr < registrationErrorInfos.length;
 iCtr++) {
            RegistrationErrorInfo registrationErrorInfo 
                = registrationErrorInfos[iCtr];
            Console.WriteLine(registrationErrorInfo.get_ErrorString());
        }
    }
    Console.Read();
}

継承階層

System.Object
  System.EnterpriseServices.RegistrationErrorInfo

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
RegistrationErrorInfo メンバ
System.EnterpriseServices 名前空間

RegistrationErrorInfo プロパティ

パブリック プロパティ

	名前	説明
	ErrorCode	オブジェクトまたはファイルのエラー コードを取得します。
	ErrorString	ErrorCode の説明を取得します。
	MajorRef	該当する場合は、エラー原因となったオブジェクトのキー値を取得します。
	MinorRef	プロパティ名など、エラー原因となった項目の具体的な仕様を取得します。
	Name	エラー原因となったオブジェクトまたはファイルの名前を取得します。

参照

関連項目

RegistrationErrorInfo クラス
System.EnterpriseServices 名前空間

RegistrationErrorInfo メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

RegistrationErrorInfo クラス
System.EnterpriseServices 名前空間

RegistrationErrorInfo メンバ

複数の COM+ オブジェクトに関連するメソッドについての拡張エラー情報を取得します。これには COM+ アプリケーションおよび COM+ コンポーネントをインストール、インポート、およびエクスポートするメソッドも含まれます。このクラスは継承できません。

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

パブリック プロパティ

	名前	説明
	ErrorCode	オブジェクトまたはファイルのエラー コードを取得します。
	ErrorString	ErrorCode の説明を取得します。
	MajorRef	該当する場合は、エラー原因となったオブジェクトのキー値を取得します。
	MinorRef	プロパティ名など、エラー原因となった項目の具体的な仕様を取得します。
	Name	エラー原因となったオブジェクトまたはファイルの名前を取得します。

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

RegistrationErrorInfo クラス
System.EnterpriseServices 名前空間