RegistrationException

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

RegistrationException クラス

登録エラーが検出されたときにスローされる例外です。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 RegistrationException
    Inherits SystemException

Visual Basic (使用法)

Dim instance As RegistrationException

C#

[SerializableAttribute] 
public sealed class RegistrationException :
 SystemException

C++

[SerializableAttribute] 
public ref class RegistrationException sealed
 : public SystemException

J#

/** @attribute SerializableAttribute() */ 
public final class RegistrationException extends
 SystemException

JScript

SerializableAttribute 
public final class RegistrationException extends
 SystemException

使用例

次のコード例には、登録例外を処理する方法を示す catch ブロックが含まれます。

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.Exception
     System.SystemException
      System.EnterpriseServices.RegistrationException

スレッド セーフ

この型の 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

参照

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

RegistrationException コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

RegistrationException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New RegistrationException

C#

public RegistrationException ()

C++

public:
RegistrationException ()

J#

public RegistrationException ()

JScript

public function RegistrationException ()

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

関連項目
RegistrationException クラス
RegistrationException メンバ
System.EnterpriseServices 名前空間

RegistrationException コンストラクタ (String)

指定したエラー メッセージを使用して、RegistrationException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    msg As String _
)

Visual Basic (使用法)

Dim msg As String

Dim instance As New RegistrationException(msg)

C#

public RegistrationException (
    string msg
)

C++

public:
RegistrationException (
    String^ msg
)

J#

public RegistrationException (
    String msg
)

JScript

public function RegistrationException (
    msg : String
)

パラメータ

msg

例外がスローされたときに、クライアントに表示するメッセージ。

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

関連項目
RegistrationException クラス
RegistrationException メンバ
System.EnterpriseServices 名前空間

RegistrationException コンストラクタ (String, Exception)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

RegistrationException クラスの新しいインスタンスを、指定したエラー メッセージと入れ子になった例外を使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    msg As String, _
    inner As Exception _
)

Visual Basic (使用法)

Dim msg As String
Dim inner As Exception

Dim instance As New RegistrationException(msg,
 inner)

C#

public RegistrationException (
    string msg,
    Exception inner
)

C++

public:
RegistrationException (
    String^ msg, 
    Exception^ inner
)

J#

public RegistrationException (
    String msg, 
    Exception inner
)

JScript

public function RegistrationException (
    msg : String, 
    inner : Exception
)

パラメータ

msg

例外がスローされたときに、クライアントに表示するメッセージ。

inner

入れ子になった例外。

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

関連項目
RegistrationException クラス
RegistrationException メンバ
System.EnterpriseServices 名前空間

RegistrationException コンストラクタ

RegistrationException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
RegistrationException ()	RegistrationException クラスの新しいインスタンスを初期化します。
RegistrationException (String)	指定したエラー メッセージを使用して、RegistrationException クラスの新しいインスタンスを初期化します。
RegistrationException (String, Exception)	RegistrationException クラスの新しいインスタンスを、指定したエラー メッセージと入れ子になった例外を使用して初期化します。

参照

関連項目

RegistrationException クラス
RegistrationException メンバ
System.EnterpriseServices 名前空間

RegistrationException プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
	ErrorInfo	登録エラーを説明する RegistrationErrorInfo オブジェクトの配列を取得します。
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。 ( Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)

参照

関連項目

RegistrationException クラス
System.EnterpriseServices 名前空間

RegistrationException メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	オーバーライドされます。 RegistrationErrorInfo のエラー情報を使用して、SerializationInfo オブジェクトを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)

プロテクト メソッド

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

参照

関連項目

RegistrationException クラス
System.EnterpriseServices 名前空間

RegistrationException メンバ

登録エラーが検出されたときにスローされる例外です。

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

パブリック コンストラクタ

	名前	説明
	RegistrationException	オーバーロードされます。 RegistrationException クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	ErrorInfo	登録エラーを説明する RegistrationErrorInfo オブジェクトの配列を取得します。
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。(Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	オーバーライドされます。 RegistrationErrorInfo のエラー情報を使用して、SerializationInfo オブジェクトを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクト メソッド

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

参照

関連項目

RegistrationException クラス
System.EnterpriseServices 名前空間