CantStartSingleInstanceException

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

CantStartSingleInstanceException クラス

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

単一インスタンス アプリケーションに対して複数のインスタンスを生成し、2 つ目以降のインスタンスが、1 つ目のアプリケーション インスタンスに接続できなかった場合、この例外がスローされます。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class CantStartSingleInstanceException
    Inherits Exception

Visual Basic (使用法)

Dim instance As CantStartSingleInstanceException

C#

[SerializableAttribute] 
public class CantStartSingleInstanceException
 : Exception

C++

[SerializableAttribute] 
public ref class CantStartSingleInstanceException
 : public Exception

J#

/** @attribute SerializableAttribute() */ 
public class CantStartSingleInstanceException
 extends Exception

JScript

SerializableAttribute 
public class CantStartSingleInstanceException
 extends Exception

解説

単一インスタンスのアプリケーションとは、同時に実行可能なインスタンスが 1 つだけであるアプリケーションをいいます。その点で、通常のアプリケーションとは異なります。複数のインスタンスを起動した場合、2 つ目以降のアプリケーション インスタンスは、1 つ目のインスタンス アプリケーションとコンタクトをとり、そのコマンド ライン引数を渡そうと試みます。2 つ目以降のアプリケーション インスタンスが、1 つ目のインスタンスとコンタクトをとれなかった場合、CantStartSingleInstanceException が生成されます。Visual Basic アプリケーション モデルでは、この例外のコンテキスト情報は一切提供されません。

詳細については、「Visual Basic アプリケーション モデルの概要」を参照してください。

継承階層

System.Object
   System.Exception
    Microsoft.VisualBasic.ApplicationServices.CantStartSingleInstanceException

スレッド セーフ

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

参照

関連項目
CantStartSingleInstanceException メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
その他の技術情報
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException コンストラクタ ()

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

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

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New CantStartSingleInstanceException

C#

public CantStartSingleInstanceException ()

C++

public:
CantStartSingleInstanceException ()

J#

public CantStartSingleInstanceException ()

JScript

public function CantStartSingleInstanceException
 ()

解説

単一インスタンスのアプリケーションとは、同時に実行可能なインスタンスが 1 つだけであるアプリケーションをいいます。その点で、通常のアプリケーションとは異なります。複数のインスタンスを起動した場合、2 つ目以降のアプリケーション インスタンスは、1 つ目のインスタンス アプリケーションとコンタクトをとり、そのコマンド ライン引数を渡そうと試みます。2 つ目以降のアプリケーション インスタンスが、1 つ目のインスタンスとコンタクトをとれなかった場合、CantStartSingleInstanceException が生成されます。詳細については、「Visual Basic アプリケーション モデルの概要」を参照してください。

CantStartSingleInstanceException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	null 参照 (Visual Basic の場合は Nothing)。
Message	ローカライズされたエラー メッセージ文字列。

プラットフォーム

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

参照

関連項目
CantStartSingleInstanceException クラス
CantStartSingleInstanceException メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
その他の技術情報
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException コンストラクタ

CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。 My.Application.StartupNextInstance イベント Visual Basic アプリケーション モデルの概要
オーバーロードの一覧

名前	説明
CantStartSingleInstanceException ()	CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。
CantStartSingleInstanceException (String)	指定したエラー メッセージを使用して、CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。
CantStartSingleInstanceException (SerializationInfo, StreamingContext)	シリアル化したデータを使用して、CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。
CantStartSingleInstanceException (String, Exception)	指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。

参照

関連項目

CantStartSingleInstanceException クラス
CantStartSingleInstanceException メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間

その他の技術情報

My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException コンストラクタ (String)

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

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

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New CantStartSingleInstanceException(message)

C#

public CantStartSingleInstanceException (
    string message
)

C++

public:
CantStartSingleInstanceException (
    String^ message
)

J#

public CantStartSingleInstanceException (
    String message
)

JScript

public function CantStartSingleInstanceException
 (
    message : String
)

パラメータ

message

エラーを説明するメッセージ。

解説

message パラメータの内容は、ユーザーが理解できる内容にします。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

CantStartSingleInstanceException は Exception から継承します。このコンストラクタは、次の表に示すように、Exception オブジェクトのプロパティを設定します。

プロパティ	値
InnerException	null 参照 (Visual Basic の場合は Nothing)。
Message	message 文字列。

プラットフォーム

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

参照

関連項目
CantStartSingleInstanceException クラス
CantStartSingleInstanceException メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
その他の技術情報
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException コンストラクタ (SerializationInfo, StreamingContext)

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

シリアル化したデータを使用して、CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New CantStartSingleInstanceException(info,
 context)

C#

protected CantStartSingleInstanceException (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
CantStartSingleInstanceException (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected CantStartSingleInstanceException (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function CantStartSingleInstanceException
 (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

スローされている例外に関するシリアル化済みオブジェクト データを保持している SerializationInfo オブジェクト。

context

転送元または転送先に関する文脈情報を格納する StreamingContext オブジェクト。

解説

このコンストラクタは、逆シリアル化中に、ストリームで送信された例外オブジェクトを再構築するために呼び出されます。詳細については、「XML シリアル化および SOAP シリアル化」を参照してください。

プラットフォーム

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

参照

関連項目
CantStartSingleInstanceException クラス
CantStartSingleInstanceException メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
その他の技術情報
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要
XML シリアル化および SOAP シリアル化

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

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

指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、CantStartSingleInstanceException クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim message As String
Dim inner As Exception

Dim instance As New CantStartSingleInstanceException(message,
 inner)

C#

public CantStartSingleInstanceException (
    string message,
    Exception inner
)

C++

public:
CantStartSingleInstanceException (
    String^ message, 
    Exception^ inner
)

J#

public CantStartSingleInstanceException (
    String message, 
    Exception inner
)

JScript

public function CantStartSingleInstanceException
 (
    message : String, 
    inner : Exception
)

パラメータ

message

エラーを説明する String オブジェクト。

inner

現在の例外の原因である Exception オブジェクト。InnerException パラメータが null 参照 (Visual Basic の場合は Nothing) でない場合は、内部例外を処理する Catch ブロックで現在の例外が発生します。

解説

message パラメータの内容は、ユーザーが理解できる内容にします。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照が格納されます。InnerException プロパティは、コンストラクタに渡されたものと同じ値を返します。InnerException プロパティによって内部例外値がコンストラクタに渡されなかった場合は、null 参照を返します。

ApplicationException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	inner 参照。
Message	message 文字列。

プラットフォーム

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

参照

関連項目
CantStartSingleInstanceException クラス
CantStartSingleInstanceException メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
その他の技術情報
My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException プロパティ

パブリック プロパティ

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

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

プロテクト プロパティ

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

参照

関連項目

CantStartSingleInstanceException クラス
Microsoft.VisualBasic.ApplicationServices 名前空間

その他の技術情報

My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

CantStartSingleInstanceException クラス
Microsoft.VisualBasic.ApplicationServices 名前空間

その他の技術情報

My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要

CantStartSingleInstanceException メンバ

単一インスタンス アプリケーションに対して複数のインスタンスを生成し、2 つ目以降のインスタンスが、1 つ目のアプリケーション インスタンスに接続できなかった場合、この例外がスローされます。

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

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

( プロテクト コンストラクタ も参照)

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

プロテクト コンストラクタ

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

パブリック プロパティ

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

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	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	派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 (Exception から継承されます。)
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクト メソッド

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

参照

関連項目

CantStartSingleInstanceException クラス
Microsoft.VisualBasic.ApplicationServices 名前空間

その他の技術情報

My.Application.StartupNextInstance イベント
Visual Basic アプリケーション モデルの概要