BooleanSwitch.Enabled プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

BooleanSwitch.Enabled プロパティ

スイッチが有効または無効かを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Enabled As
 Boolean

Visual Basic (使用法)

Dim instance As BooleanSwitch
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

public bool Enabled { get;
 set; }

C++

public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled ()

/** @property */
public void set_Enabled (boolean value)

JScript

public function get Enabled
 () : boolean

public function set Enabled
 (value : boolean)

プロパティ値
スイッチを有効にする場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
SecurityException	呼び出し元に、正しいアクセス許可がありません。

解説

既定では、このフィールドは false (無効) に設定されます。スイッチを有効にするには、このフィールドに値 true を設定します。スイッチを無効にするには、値を false に設定します。このプロパティの値は、基本クラスプロパティ SwitchSetting の値によって決まります。

メモ
このメソッドは SecurityAction.LinkDemand フラグを使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。

メモ

このメソッドは SecurityAction.LinkDemand フラグを使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。

使用例

BooleanSwitch を作成し、スイッチを使用してエラーメッセージを出力するかどうかを決定するコード例を次に示します。スイッチはクラスレベルで作成されます。Main メソッドは、その位置をエラーメッセージとエラーの発生場所を出力する MyMethod に渡します。

Visual Basic

'Class level declaration.
' Create a BooleanSwitch for data. 
Private Shared dataSwitch As
 New BooleanSwitch("Data", "DataAccess
 module")


Public Shared Sub MyMethod(location
 As String)
    'Insert code here to handle processing.
    If dataSwitch.Enabled Then
        Console.WriteLine(("Error happened at " +
 location))
    End If
End Sub 'MyMethod

'Entry point which delegates to C-style main Private Function
Public Overloads Shared
 Sub Main()
    Main(System.Environment.GetCommandLineArgs())
End Sub
 
Overloads Public Shared
 Sub Main(args() As String)
    'Run the method that writes an error message specifying the location
 of the error.
    MyMethod("in Main")
End Sub 'Main

//Class level declaration.
 /* Create a BooleanSwitch for data.*/
 static BooleanSwitch dataSwitch = new BooleanSwitch("Data",
 "DataAccess module");
 
 static public void MyMethod(string
 location) {
    //Insert code here to handle processing.
    if(dataSwitch.Enabled)
       Console.WriteLine("Error happened at " + location);
 }
 
 public static void Main(string[]
 args) {
    //Run the method that writes an error message specifying the location
 of the error.
    MyMethod("in Main");
 }

C++

public ref class BooleanSwitchTest
{
private:

   /* Create a BooleanSwitch for data.*/
   static BooleanSwitch^ dataSwitch = gcnew BooleanSwitch( "Data","DataAccess
 module" );

public:
   static void MyMethod( String^ location )
   {
      
      //Insert code here to handle processing.
      if ( dataSwitch->Enabled )
            Console::WriteLine( "Error happened at {0}", location );
   }

};

int main()
{
   
   //Run the method that writes an error message specifying the location
 of the error.
   BooleanSwitchTest::MyMethod( "in main" );
}

// Class level declaration.
/* Create a BooleanSwitch for data.
 */
private static BooleanSwitch dataSwitch = 
    new BooleanSwitch("Data", "DataAccess module");

public static void MyMethod(String
 location)
{
    //Insert code here to handle processing.
    if (dataSwitch.get_Enabled()) {
        Console.WriteLine("Error happened at " + location);
    }
} //MyMethod

public static void main(String[]
 args)
{
    // Run the method that writes an error message specifying the location
    // of the error.
    MyMethod("in main");
} //main

JScript

//Class level declaration.
 /* Create a BooleanSwitch for data.*/
 static var dataSwitch : BooleanSwitch = new
 BooleanSwitch("Data", "DataAccess module");
 
 static public function
 MyMethod(location : String) {
    //Insert code here to handle processing.
    if(dataSwitch.Enabled)
       Console.WriteLine("Error happened at " + location);
 }
 
 public static function
 Main(args : String[]) {
    //Run the method that writes an error message specifying the location
 of the error.
    MyMethod("in Main");
 }