Export (0) Print
Expand All

OperatingSystem Constructor

Initializes a new instance of the OperatingSystem class, using the specified platform identifier value and version object.

[Visual Basic]
Public Sub New( _
   ByVal platform As PlatformID, _
   ByVal version As Version _
)
[C#]
public OperatingSystem(
   PlatformID platform,
 Version version
);
[C++]
public: OperatingSystem(
   PlatformID platform,
 Version* version
);
[JScript]
public function OperatingSystem(
   platform : PlatformID,
 version : Version
);

Parameters

platform
A PlatformID enumerated constant that indicates the operating system platform.
version
A Version object that indicates the version of the operating system.

Exceptions

Exception Type Condition
ArgumentNullException version is a null reference (Nothing in Visual Basic).

Example

[Visual Basic, C#, C++] The following code example creates objects of the OperatingSystem class with selected values for the Platform and Version properties.

[Visual Basic] 
' Example for the OperatingSystem constructor and the  
' OperatingSystem.ToString( ) method.
Imports System
Imports Microsoft.VisualBasic

Module OpSysConstructDemo
    
    ' Create and display an OperatingSystem object.
    Sub BuildOSObj( pID As PlatformID, ver As Version )

        Dim os As New OperatingSystem( pID, ver )

        Console.WriteLine( "   {0}", os.ToString( ) )
    End Sub 
        
    Sub BuildOperatingSystemObjects( )

        ' The Version object does not need to correspond to an 
        ' actual OS version.
        Dim verNull     As New Version( )
        Dim verMajMin   As New Version( 3, 11 )
        Dim verMMBld    As New Version( 5, 25, 625 )
        Dim verMMBVer   As New Version( 5, 6, 7, 8 )
        Dim verString   As New Version( "3.5.8.13" )
            
        ' All PlatformID members are shown here.
        BuildOSObj( PlatformID.Win32NT, verNull )
        BuildOSObj( PlatformID.Win32S, verMajMin )
        BuildOSObj( PlatformID.Win32Windows, verMMBld )
        BuildOSObj( PlatformID.WinCE, verMMBVer )
        BuildOSObj( PlatformID.Win32NT, verString )
    End Sub 
        
    Sub Main( )
        Console.WriteLine( _
            "This example of the OperatingSystem constructor " & _
            "and " & vbCrLf & "OperatingSystem.ToString( ) " & _
            "generates the following output." & vbCrLf )
        Console.WriteLine( _
            "Create and display several different " & _
            "OperatingSystem objects:" & vbCrLf )

        BuildOperatingSystemObjects( )
            
        Console.WriteLine(vbCrLf & _
            "The OS version of the host computer is: " & _
            vbCrLf & vbCrLf & "   {0}", _
            Environment.OSVersion.ToString( ) )
    End Sub
End Module 

' This example of the OperatingSystem constructor and
' OperatingSystem.ToString( ) generates the following output.
' 
' Create and display several different OperatingSystem objects:
' 
'    Microsoft Windows NT 0.0
'    Microsoft Win32S 3.11
'    Microsoft Windows 98 5.25.625
'    Microsoft Windows CE 5.6.7.8
'    Microsoft Windows NT 3.5.8.13
' 
' The OS version of the host computer is:
' 
'    Microsoft Windows NT 5.1.2600.0

[C#] 
// Example for the OperatingSystem constructor and the 
// OperatingSystem.ToString( ) method.
using System;

class OpSysConstructDemo 
{
    // Create and display an OperatingSystem object.
    static void BuildOSObj( PlatformID pID, Version ver )
    {
        OperatingSystem os = new OperatingSystem( pID, ver );

        Console.WriteLine( "   {0}", os.ToString( ) );
    }

    static void BuildOperatingSystemObjects( )
    {
        // The Version object does not need to correspond to an 
        // actual OS version.
        Version verNull     = new Version( );
        Version verMajMin   = new Version( 3, 11 );
        Version verMMBld    = new Version( 5, 25, 625 );
        Version verMMBVer   = new Version( 5, 6, 7, 8 );
        Version verString   = new Version( "3.5.8.13" );

        // All PlatformID members are shown here.
        BuildOSObj( PlatformID.Win32NT, verNull );
        BuildOSObj( PlatformID.Win32S, verMajMin );
        BuildOSObj( PlatformID.Win32Windows, verMMBld );
        BuildOSObj( PlatformID.WinCE, verMMBVer );
        BuildOSObj( PlatformID.Win32NT, verString );
    }

    public static void Main( ) 
    {
        Console.WriteLine( 
            "This example of the OperatingSystem constructor " +
            "and \nOperatingSystem.ToString( ) " +
            "generates the following output.\n" );
        Console.WriteLine( 
            "Create and display several different " +
            "OperatingSystem objects:\n" );

        BuildOperatingSystemObjects( );

        Console.WriteLine( 
            "\nThe OS version of the host computer is:\n\n   {0}", 
            Environment.OSVersion.ToString( ) );
    }
}

/*
This example of the OperatingSystem constructor and
OperatingSystem.ToString( ) generates the following output.

Create and display several different OperatingSystem objects:

   Microsoft Windows NT 0.0
   Microsoft Win32S 3.11
   Microsoft Windows 98 5.25.625
   Microsoft Windows CE 5.6.7.8
   Microsoft Windows NT 3.5.8.13

The OS version of the host computer is:

   Microsoft Windows NT 5.1.2600.0
*/

[C++] 
// Example for the OperatingSystem constructor and the 
// OperatingSystem::ToString( ) method.
#using <mscorlib.dll>
using namespace System;

// Create and display an OperatingSystem object.
void BuildOSObj( PlatformID pID, Version* ver )
{
    OperatingSystem* os = new OperatingSystem( pID, ver );

    Console::WriteLine( S"   {0}", os->ToString( ) );
}

void BuildOperatingSystemObjects( )
{
    // The Version object does not need to correspond to an 
    // actual OS version.
    Version* verNull     = new Version( );
    Version* verMajMin   = new Version( 3, 11 );
    Version* verMMBld    = new Version( 5, 25, 625 );
    Version* verMMBVer   = new Version( 5, 6, 7, 8 );
    Version* verString   = new Version( S"3.5.8.13" );

    // All PlatformID members are shown here.
    BuildOSObj( PlatformID::Win32NT, verNull );
    BuildOSObj( PlatformID::Win32S, verMajMin );
    BuildOSObj( PlatformID::Win32Windows, verMMBld );
    BuildOSObj( PlatformID::WinCE, verMMBVer );
    BuildOSObj( PlatformID::Win32NT, verString );
}

void main( ) 
{
    Console::WriteLine( 
        S"This example of the OperatingSystem constructor and \n" 
        S"OperatingSystem::ToString( ) generates the following "
        S"output.\n" );
    Console::WriteLine( 
        S"Create and display several different " 
        S"OperatingSystem objects:\n" );

    BuildOperatingSystemObjects( );

    Console::WriteLine( 
        S"\nThe OS version of the host computer is:\n\n   {0}", 
        Environment::OSVersion->ToString( ) );
}

/*
This example of the OperatingSystem constructor and
OperatingSystem::ToString( ) generates the following output.

Create and display several different OperatingSystem objects:

   Microsoft Windows NT 0.0
   Microsoft Win32S 3.11
   Microsoft Windows 98 5.25.625
   Microsoft Windows CE 5.6.7.8
   Microsoft Windows NT 3.5.8.13

The OS version of the host computer is:

   Microsoft Windows NT 5.1.2600.0
*/

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

OperatingSystem Class | OperatingSystem Members | System Namespace

Show:
© 2014 Microsoft