Click here to Skip to main content
15,867,686 members
Articles / Programming Languages / C++

Introduction to Managed C++

Rate me:
Please Sign up or sign in to vote.
4.78/5 (20 votes)
7 Jul 2002CPOL6 min read 328K   1.6K   50   46
An attempt to get a beginner started on Managed C++

Introduction

This is intended as a jump-start tutorial for Managed C++ programming. It does not cover every aspect of the managed extensions, but it does cover certain areas that are often puzzling to someone coming from a C# or a native C++ background. The article assumes that the reader is familiar with the basic elements of .NET technology and that the user can understand C++ code when he or she sees it.

Simple program

MC++
#using <mscorlib.dll>

using namespace System;

int _tmain(void)
{
    return 0;
}

#using is a preprocessor directive that imports meta data from a .NET module or library. In our small program we have used #using on mscorlib.dll which is an essential library for all .NET programs. Just using #using gives us access to all the namespaces and classes in that module or library. But we'd have to type the fully qualified name for each class we use, including the namespace or namespaces if any. We can use the using namespace directive which will allow us to use class names without having to use the namespace-name explicitly.

For example I can write this :-

MC++
System::Console::WriteLine("Hello Earth");

But if I have used a using namespace directive, then I can use :-

MC++
using namespace System;
...
Console::WriteLine("Hello Earth");

It's mostly a matter of readability. Some people might prefer to use fully qualified names to improve the clarity of their code. And sometimes you are forced to, as when two namespaces have classes with the same names in which case the compiler gets confused.

Managed classes

A managed class is a class that is garbage collected, means you don't have to delete it after using it. All that's managed for you by the common language runtime. In MC++ we create managed classes using the __gc keyword as shown below.

MC++
__gc class First
{
public:
    First()
    {
        m_name = "Anonymous";
    }
    First(String* s)
    {
        m_name = s;
    }
    String* GetName()
    {
        return m_name;
    }
    void SetName(String* s)
    {
        m_name = s;
    }
private:
    String* m_name;
};

Well, it looks more or less like a normal C++ class except that we have used the __gc keyword when declaring it. That marks it as managed. You'll also notice how I have used String* instead of String. This is because the String class is a managed class that can only be declared on the heap.

MC++
First* f1 = new First();
First* f2 = new First("Andrew");
Console::WriteLine(f1->GetName());
Console::WriteLine(f2->GetName());
f2->SetName("Peace");
Console::WriteLine(f2->GetName());

Using the managed class is not dissimilar from using a normal old-style C++ class. Except that I cannot declare objects of type First, I have to declare them on the heap using First* and new. As you might observe, I have not called delete. Hey, don't look at me with that sort of gleam in your eyes as if to tell me that I should not be so careless. I didn't call delete because it's not required that I do so. This is Managed C++ we are talking about, remember. And because First is a managed class, the common language runtime will automatically delete the objects that are no longer under use, using it's garbage collector. Very handy, I say very handy!

Using properties

Take a look at the two listings below :-

MC++
//Listing A
f2->SetName("Peace");
Console::WriteLine(f2->GetName());
MC++
//Listing B
f2->Name = "Colin";
Console::WriteLine(f2->Name);

Obviously the second listing is more readable. Of course using a public member variable would be a very impetuous idea and one that would result in a lot of scornful looks from most programmers. But in .NET we have properties, in fact I have some rather vague ideas that the native C++ compiler supports properties too, but since the vagueness is rather strong, I better keep quiet about that one.

MC++
__gc class First
{
public:

...

    __property String* get_Name()
    {
        return m_name;
    }
    __property void set_Name(String* s)
    {
        m_name = s;
    }

...

};

If you have only a get_ function then your property is read-only. If you have only the set_ function you have a write-only property. And in our case, since we have both get_ and set_ functions, we have a read-and-write property. The get_ function's return type must be same as the set_ function's argument. MSDN adds that you cannot define a property that has the same name as the containing class.

Boxing

Consider the function below :-

MC++
void Show(Object* o)
{
    Console::WriteLine(o);
}

Rather neat, eh? It takes an object of type Object and displays it on the console. Now see this snippet of code.

MC++
String* s1 = "Hello World";
Show(s1);

Compiles and works fine. Now see the following snippet of code.

MC++
int i = 100;
Show(i); //This won't compile

Blast! That won't even compile. You'll get compiler error C2664: 'Show' : cannot convert parameter 1 from 'int' to 'System::Object __gc *'. This is where we need to use the __box keyword.

MC++
int i = 100;
Show(__box(i));

What __box does is simple. It creates a new managed object on the heap and copies the value type object into the managed object. And it returns the managed object which is actually a copy of the original value type object. This means that if you modify the managed object returned by an __box, the original object won't change at all.

Unboxing

Obviously if you can box, you should be able to unbox too, eh? Let's say we want to box a value object to an Object and then unbox it back to a value object. The following code snippet shows you how to accomplish this chore.

MC++
Object* o1 = __box(i);
int j = *static_cast<__box int*>(o1);
j *= 3;
Show(__box(j));

Good heavens! That turned out to be rather more sinister looking than you had expected I bet. What we do is to cast the managed object to the __gc pointer on the CLR heap and then we simply dereference it. You can use dynamic_cast instead of static_cast for increased type-safety.

Native code blocks

Consider the following function.

MC++
void NativeCall()
{
    puts("This is printed from a native function");
}

As you can see, it uses purely normal non-.NET stuff. Obviously we can improve execution speed if we can compile this function as native. MC++ provides us with the #pragma managed and #pragma unmanaged preprocessor directives. We simply add a #pragma unmanaged just before the function and then add a #pragma managed just after the function.

MC++
#pragma unmanaged

void NativeCall()
{
    ...
}

#pragma managed

Now when this function is encountered during program execution, the common language runtime will pass on control to the native platform. Obviously we must use this whenever we have functions that use fully unmanaged functions. What's real neat is that we call call unmanaged functions that are marked as #pragma unmanaged from within managed blocks of code.

__value classes

Earlier I had said that managed classes cannot be allocated on the stack. Sometimes, we might have the requirement for a very simple class, often merely for storing some values. In such cases it might be desirable to have a value type class that can be allocated on the stack. That's where the __value keyword comes in. The following code snippet shows you how to declare a value type class.

MC++
__value class Second
{
public:
    void Abc()
    {
        Console::WriteLine("Second::Abc");
    }
};

Now we can declare objects of type Second on the stack.

MC++
Second sec;
sec.Abc();

In fact we can even declare them on the heap. But remember this won't be the CLR managed heap and thus we need to delete our objects on our own.

MC++
Second* psec = __nogc new Second();
psec->Abc();
delete psec;

More reading

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
United States United States
Nish Nishant is a technology enthusiast from Columbus, Ohio. He has over 20 years of software industry experience in various roles including Chief Technology Officer, Senior Solution Architect, Lead Software Architect, Principal Software Engineer, and Engineering/Architecture Team Leader. Nish is a 14-time recipient of the Microsoft Visual C++ MVP Award.

Nish authored C++/CLI in Action for Manning Publications in 2005, and co-authored Extending MFC Applications with the .NET Framework for Addison Wesley in 2003. In addition, he has over 140 published technology articles on CodeProject.com and another 250+ blog articles on his WordPress blog. Nish is experienced in technology leadership, solution architecture, software architecture, cloud development (AWS and Azure), REST services, software engineering best practices, CI/CD, mentoring, and directing all stages of software development.

Nish's Technology Blog : voidnish.wordpress.com

Comments and Discussions

 
QuestionWhy slowdown operation!? Pin
murti3866-Feb-07 7:19
murti3866-Feb-07 7:19 
GeneralManaging MFC Pin
Jain Mohit8-Mar-04 22:00
Jain Mohit8-Mar-04 22:00 
GeneralPlatform SDK with Unmanaged interface Pin
PawanKishore20-Feb-04 20:09
PawanKishore20-Feb-04 20:09 
GeneralManaged C++ classes Pin
ricky_casson9-Jan-04 12:37
ricky_casson9-Jan-04 12:37 
GeneralCreating objects of unmanaged C++ in managed C++ Pin
moist10-Aug-03 20:16
moist10-Aug-03 20:16 
GeneralRe: Creating objects of unmanaged C++ in managed C++ Pin
Nish Nishant11-Aug-03 6:59
sitebuilderNish Nishant11-Aug-03 6:59 
GeneralRe: Creating objects of unmanaged C++ in managed C++ Pin
moist11-Aug-03 14:48
moist11-Aug-03 14:48 
GeneralRe: Creating objects of unmanaged C++ in managed C++ Pin
Nish Nishant11-Aug-03 15:32
sitebuilderNish Nishant11-Aug-03 15:32 
QuestionWhat about C using Unmanaged C Static Libraries ? Pin
Anonymous26-May-03 1:37
Anonymous26-May-03 1:37 
Generalusing Hashtable in MC++ Pin
haranath25-Apr-03 5:58
haranath25-Apr-03 5:58 
GeneralRe: using Hashtable in MC++ Pin
Nemanja Trifunovic25-Apr-03 6:13
Nemanja Trifunovic25-Apr-03 6:13 
GeneralRe: using Hashtable in MC++ Pin
haranath27-Apr-03 21:57
haranath27-Apr-03 21:57 
GeneralRe: using Hashtable in MC++ Pin
MarkTheShark17-Feb-05 12:42
MarkTheShark17-Feb-05 12:42 
GeneralHello, Nishant Pin
Anthony_Yio10-Dec-02 16:52
Anthony_Yio10-Dec-02 16:52 
GeneralRe: Hello, Nishant Pin
Nish Nishant26-Dec-02 10:26
sitebuilderNish Nishant26-Dec-02 10:26 
GeneralBrilliant Style Pin
Yusuf Jiruwala9-Dec-02 8:23
Yusuf Jiruwala9-Dec-02 8:23 
GeneralRe: Brilliant Style Pin
Nish Nishant26-Dec-02 10:25
sitebuilderNish Nishant26-Dec-02 10:25 
Thanks Yusuf. I guess there are already quite a few articles on hooks here on CP. But if I get anything different to write about regrading hooks, I'll give it a go.

Nish Smile | :)


Author of the romantic comedy

Summer Love and Some more Cricket [New Win]

Review by Shog9
Click here for review[NW]

GeneralThanks Nish Pin
Paul Watson23-Jul-02 5:29
sitebuilderPaul Watson23-Jul-02 5:29 
GeneralRe: Thanks Nish Pin
Nish Nishant23-Jul-02 6:33
sitebuilderNish Nishant23-Jul-02 6:33 
QuestionHow slow is it? Pin
Miguel Lopes9-Jul-02 8:21
Miguel Lopes9-Jul-02 8:21 
AnswerRe: How slow is it? Pin
Nish Nishant9-Jul-02 9:06
sitebuilderNish Nishant9-Jul-02 9:06 
GeneralRe: How slow is it? Pin
pankajdaga12-Jul-02 0:25
pankajdaga12-Jul-02 0:25 
GeneralRe: How slow is it? Pin
Nish Nishant13-Jul-02 0:41
sitebuilderNish Nishant13-Jul-02 0:41 
AnswerRe: How slow is it? Pin
Nemanja Trifunovic23-Jul-02 6:09
Nemanja Trifunovic23-Jul-02 6:09 
GeneralRe: How slow is it? Pin
Nish Nishant23-Jul-02 6:37
sitebuilderNish Nishant23-Jul-02 6:37 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.