ManagementCreateAttribute Class (System.Management.Instrumentation)

.NET Framework Class Library

ManagementCreateAttribute Class

The ManagementCreateAttribute is used to indicate that a method creates a new instance of a managed entity.

Namespace: System.Management.Instrumentation
Assembly: System.Core (in System.Core.dll)

Syntax

Visual Basic (Declaration)

<AttributeUsageAttribute(AttributeTargets.Constructor Or AttributeTargets.Method, AllowMultiple := False)> _
<HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort := True)> _
Public NotInheritable Class ManagementCreateAttribute _
    Inherits ManagementNewInstanceAttribute

Visual Basic (Usage)

Dim instance As ManagementCreateAttribute

[AttributeUsageAttribute(AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple = false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public sealed class ManagementCreateAttribute : ManagementNewInstanceAttribute

Visual C++

[AttributeUsageAttribute(AttributeTargets::Constructor|AttributeTargets::Method, AllowMultiple = false)]
[HostProtectionAttribute(SecurityAction::LinkDemand, MayLeakOnAbort = true)]
public ref class ManagementCreateAttribute sealed : public ManagementNewInstanceAttribute

JScript

public final class ManagementCreateAttribute extends ManagementNewInstanceAttribute

Remarks

Note:
The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: MayLeakOnAbort. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

Note:

The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: MayLeakOnAbort. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

The lifetime of a managed entity is not bound to the lifetime of the .NET object representing it. The provider can use the method marked with this attribute to create a new instance of the corresponding managed entity.

The method parameters should have the same name and type as the parameters of the class binding constructor.

Use of this attribute does not have any affect on registration of the WMI class in the repository. It is only used at runtime.

Examples

The following example demonstrates how to use the ManagementCreate attribute.

[ManagementEntity]
public class ProcessInstance
{
     [ManagementKey]
     public int Id; 

     [ManagementCreate]
     public ProcessInstance StartProcess(string cmdLine)
     {
        ProcessInstance newProcess = new ProcessInstance(cmdLine);
        newProcess.Start();
        return newProcess;
     }
}

Inheritance Hierarchy

System..::.Object
  System..::.Attribute
    System.Management.Instrumentation..::.ManagementMemberAttribute
      System.Management.Instrumentation..::.ManagementNewInstanceAttribute
        System.Management.Instrumentation..::.ManagementCreateAttribute

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5

Reference

ManagementCreateAttribute Members

System.Management.Instrumentation Namespace