ManagementClass.CreateInstance メソッド

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

ManagementClass.CreateInstance メソッド

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

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

Visual Basic (宣言)

Public Function CreateInstance As
 ManagementObject

Visual Basic (使用法)

Dim instance As ManagementClass
Dim returnValue As ManagementObject

returnValue = instance.CreateInstance

C#

public ManagementObject CreateInstance ()

C++

public:
ManagementObject^ CreateInstance ()

J#

public ManagementObject CreateInstance ()

JScript

public function CreateInstance () : ManagementObject

戻り値
WMI クラスの新しいインスタンスを表す ManagementObject。

解説

新しいインスタンスは、Put () メソッドを呼び出すまでコミットされないことに注意してください。コミットする前に、主要なプロパティを指定する必要があります。

.NET Framework のセキュリティ

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

使用例

ManagementClass コンストラクタを使用して ManagementClass 変数を初期化し、WMI クラスの新しいインスタンスを作成する例を次に示します。

Visual Basic

Imports System
Imports System.Management


Class Sample
    Public Overloads Shared
 Function _
        Main(ByVal args() As String)
 As Integer

        Dim envClass As New
 ManagementClass( _
            "Win32_Environment")
        Dim newInstance As ManagementObject

        newInstance = envClass.CreateInstance()
        newInstance("Name") = "testEnvironmentVariable"
        newInstance("VariableValue") = "testValue"
        newInstance("UserName") = "<SYSTEM>"
        newInstance.Put()  'to commit the new instance.

    End Function
End Class

C#

using System;
using System.Management;

public class Sample 
{    
    public static void Main()
 
    {

        ManagementClass envClass = 
            new ManagementClass("Win32_Environment");
        ManagementObject newInstance = 
            envClass.CreateInstance();
        newInstance["Name"] = "testEnvironmentVariable";
        newInstance["VariableValue"] = "testValue";
        newInstance["UserName"] = "<SYSTEM>";
        newInstance.Put(); //to commit the new instance.


    }
}

.NET Framework のセキュリティ

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

プラットフォーム

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、1.1、1.0

参照

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