SettingChangingEventArgs

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

SettingChangingEventArgs クラス

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

SettingChanging イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class SettingChangingEventArgs
    Inherits CancelEventArgs

Visual Basic (使用法)

Dim instance As SettingChangingEventArgs

C#

public class SettingChangingEventArgs : CancelEventArgs

C++

public ref class SettingChangingEventArgs :
 public CancelEventArgs

J#

public class SettingChangingEventArgs extends
 CancelEventArgs

JScript

public class SettingChangingEventArgs extends
 CancelEventArgs

解説

SettingChangingEventArgs クラスは、アプリケーション設定プロパティの値が変更されようとしていることを通知する SettingChanging イベントのデータを提供します。このイベントの最も一般的な発生源は、ApplicationSettingsBase クラスの Item メソッドの get アクセサです。

SettingChangingEventArgs は CancelEventArgs から派生しているため、ハンドラには書き込み操作をキャンセルできるオプションがあります。

継承階層

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Configuration.SettingChangingEventArgs

スレッド セーフ

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

参照

関連項目
SettingChangingEventArgs メンバ
System.Configuration 名前空間
SettingChangingEventHandler
ApplicationSettingsBase.SettingChanging イベント
ApplicationSettingsBase.SettingChanging イベント

SettingChangingEventArgs コンストラクタ

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

SettingChangingEventArgs クラスのインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    settingName As String, _
    settingClass As String, _
    settingKey As String, _
    newValue As Object, _
    cancel As Boolean _
)

Visual Basic (使用法)

Dim settingName As String
Dim settingClass As String
Dim settingKey As String
Dim newValue As Object
Dim cancel As Boolean

Dim instance As New SettingChangingEventArgs(settingName,
 settingClass, settingKey, newValue, cancel)

C#

public SettingChangingEventArgs (
    string settingName,
    string settingClass,
    string settingKey,
    Object newValue,
    bool cancel
)

C++

public:
SettingChangingEventArgs (
    String^ settingName, 
    String^ settingClass, 
    String^ settingKey, 
    Object^ newValue, 
    bool cancel
)

J#

public SettingChangingEventArgs (
    String settingName, 
    String settingClass, 
    String settingKey, 
    Object newValue, 
    boolean cancel
)

JScript

public function SettingChangingEventArgs (
    settingName : String, 
    settingClass : String, 
    settingKey : String, 
    newValue : Object, 
    cancel : boolean
)

パラメータ

settingName

アプリケーション設定の名前を格納している String。

settingClass

設定のカテゴリの説明を格納している String。多くの場合、このパラメータは、アプリケーション設定グループ名に設定されます。

settingKey

アプリケーション設定キーを格納している String。

newValue

アプリケーション設定プロパティに割り当てられる新しい値を格納している Object。

cancel

イベントをキャンセルする場合は true。それ以外の場合は false。

解説

SettingChangingEventArgs コンストラクタは、パラメータの値を SettingChangingEventArgs クラスの対応するプロパティに割り当てるだけです。

プラットフォーム

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

参照

関連項目
SettingChangingEventArgs クラス
SettingChangingEventArgs メンバ
System.Configuration 名前空間
SettingName
SettingClass
SettingKey
NewValue
Cancel

SettingChangingEventArgs プロパティ

パブリック プロパティ

	名前	説明
	Cancel	イベントをキャンセルするかどうかを示す値を取得または設定します。 ( CancelEventArgs から継承されます。)
	NewValue	アプリケーション設定プロパティに割り当てられる新しい値を取得します。
	SettingClass	アプリケーション設定プロパティのカテゴリを取得します。
	SettingKey	プロパティに関連付けられたアプリケーション設定キーを取得します。
	SettingName	アプリケーション設定プロパティに関連付けられたアプリケーション設定の名前を取得します。

参照

関連項目

SettingChangingEventArgs クラス
System.Configuration 名前空間
SettingChangingEventHandler
ApplicationSettingsBase.SettingChanging イベント
ApplicationSettingsBase.SettingChanging イベント

SettingChangingEventArgs メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

SettingChangingEventArgs クラス
System.Configuration 名前空間
SettingChangingEventHandler
ApplicationSettingsBase.SettingChanging イベント
ApplicationSettingsBase.SettingChanging イベント

SettingChangingEventArgs メンバ

SettingChanging イベントのデータを提供します。

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

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

	名前	説明
	SettingChangingEventArgs	SettingChangingEventArgs クラスのインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Cancel	イベントをキャンセルするかどうかを示す値を取得または設定します。(CancelEventArgs から継承されます。)
	NewValue	アプリケーション設定プロパティに割り当てられる新しい値を取得します。
	SettingClass	アプリケーション設定プロパティのカテゴリを取得します。
	SettingKey	プロパティに関連付けられたアプリケーション設定キーを取得します。
	SettingName	アプリケーション設定プロパティに関連付けられたアプリケーション設定の名前を取得します。

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

SettingChangingEventArgs クラス
System.Configuration 名前空間
SettingChangingEventHandler
ApplicationSettingsBase.SettingChanging イベント
ApplicationSettingsBase.SettingChanging イベント