如何:显示来自程序集的一个STL/CLR容器

项目
02/21/2013

STL/CLR 容器例如 list 和 map 实现为模板 ref 类。由于 C++ 模板在编译时，具有相同的签名，但在两个模板类在不同的程序集实际上是不同的类型。这意味着模板类不能跨程序集边界使用。

允许跨程序集共享成为可能， STL/CLR 容器实现泛型接口 ICollection<T>。使用此泛型接口，支持泛型，包括 C++、 C# 和 Visual Basic 的语言，可以访问 STL/CLR 容器。

本主题演示如何显示在 c. 编写的若干 STL/CLR 容器的元素 C++ 程序集中名为 StlClrClassLibrary。将显示两个程序集访问 StlClrClassLibrary。第一个程序集在 C++ 和第二个集合中编写在 c# 中。

如果两个程序集在 C++ 编写的，使用其 generic_container typedef，可以访问容器的泛型接口。例如，因此，如果您有一个容器类型 cliext::vector<int>，然后其泛型接口是: cliext::vector<int>::generic_container。同样，使用 generic_iterator typedef，在中，您可以获取泛型接口中的一个迭代器: cliext::vector<int>::generic_iterator。

由于这些函数在 C++ 头文件中声明，其他语言编写的程序集不能使用它们。因此，访问 cliext::vector<int> 泛型接口用 C# 或任何其他 .NET 语言，使用 System.Collections.Generic.ICollection<int>。若要循环访问该集合，请使用一个 foreach 循环。

下表列出了泛型接口其中每个 STL/CLR 容器实现:

STL/CLR 容器	泛型接口
、向量、双端队列<T>	ICollection<T>
hash_map<K， V>	IDictionary<K， V>
hash_multimap<K， V>	IDictionary<K， V>
hash_multiset<T>	ICollection<T>
hash_set<T>	ICollection<T>
列表<T>	ICollection<T>
映射<K， V>	IDictionary<K， V>
基于<K， V>	IDictionary<K， V>
多级集<T>	ICollection<T>
设置<T>	ICollection<T>
检测<T>	ICollection<T>

备注

由于 queue、 priority_queue和 stack 容器不支持迭代器，它们不实现泛型接口，并且不能是捕获的交叉的程序集。

示例 1

说明

在此示例中，我们声明包含私有 STL/CLR 成员数据的 c. C++ 类。我们然后为公共方法对类的私人集合的授予访问。完成它以两种不同的方式，一 C++ 客户端另一其他 .NET 客户端的。

代码

// StlClrClassLibrary.h
#pragma once

#include <cliext/deque>
#include <cliext/list>
#include <cliext/map>
#include <cliext/set>
#include <cliext/stack>
#include <cliext/vector>

using namespace System;
using namespace System::Collections::Generic;
using namespace cliext;

namespace StlClrClassLibrary {

    public ref class StlClrClass
    {
    public:
        StlClrClass();

        // These methods can be called by a C++ class
        // in another assembly to get access to the
        // private STL/CLR types defined below.
        deque<wchar_t>::generic_container ^GetDequeCpp();
        list<float>::generic_container ^GetListCpp();
        map<int, String ^>::generic_container ^GetMapCpp();
        set<double>::generic_container ^GetSetCpp();
        vector<int>::generic_container ^GetVectorCpp();

        // These methods can be called by a non-C++ class
        // in another assembly to get access to the
        // private STL/CLR types defined below.
        ICollection<wchar_t> ^GetDequeCs();
        ICollection<float> ^GetListCs();
        IDictionary<int, String ^> ^GetMapCs();
        ICollection<double> ^GetSetCs();
        ICollection<int> ^GetVectorCs();

    private:
        deque<wchar_t> ^aDeque;
        list<float> ^aList;
        map<int, String ^> ^aMap;
        set<double> ^aSet;
        vector<int> ^aVector;
    };
}

示例 2

说明

在此示例中，我们实现在示例中声明的类 1. 中。为了客户端可以使用此类库，我们使用清单工具 mt.exe 嵌入清单文件添加到 DLL。有关详细信息，请参见代码注释。

有关清单工具和并行程序集的更多信息，请参见生成 C/C++ 独立应用程序和并行程序集。

代码

// StlClrClassLibrary.cpp
// compile with: /clr /LD /link /manifest
// post-build command: (attrib -r StlClrClassLibrary.dll & mt /manifest StlClrClassLibrary.dll.manifest /outputresource:StlClrClassLibrary.dll;#2 & attrib +r StlClrClassLibrary.dll)

#include "StlClrClassLibrary.h"

namespace StlClrClassLibrary
{
    StlClrClass::StlClrClass()
    {
        aDeque = gcnew deque<wchar_t>();
        aDeque->push_back(L'a');
        aDeque->push_back(L'b');

        aList = gcnew list<float>();
        aList->push_back(3.14159f);
        aList->push_back(2.71828f);

        aMap = gcnew map<int, String ^>();
        aMap[0] = "Hello";
        aMap[1] = "World";

        aSet = gcnew set<double>();
        aSet->insert(3.14159);
        aSet->insert(2.71828);

        aVector = gcnew vector<int>();
        aVector->push_back(10);
        aVector->push_back(20);
    }

    deque<wchar_t>::generic_container ^StlClrClass::GetDequeCpp()
    {
        return aDeque;
    }

    list<float>::generic_container ^StlClrClass::GetListCpp()
    {
        return aList;
    }

    map<int, String ^>::generic_container ^StlClrClass::GetMapCpp()
    {
        return aMap;
    }

    set<double>::generic_container ^StlClrClass::GetSetCpp()
    {
        return aSet;
    }

    vector<int>::generic_container ^StlClrClass::GetVectorCpp()
    {
        return aVector;
    }

    ICollection<wchar_t> ^StlClrClass::GetDequeCs()
    {
        return aDeque;
    }

    ICollection<float> ^StlClrClass::GetListCs()
    {
        return aList;
    }

    IDictionary<int, String ^> ^StlClrClass::GetMapCs()
    {
        return aMap;
    }

    ICollection<double> ^StlClrClass::GetSetCs()
    {
        return aSet;
    }

    ICollection<int> ^StlClrClass::GetVectorCs()
    {
        return aVector;
    }
}

示例 3

说明

在此示例中，我们创建使用示例创建类库、 1 和 2. 的 c. C++ 客户端。此客户端使用 STL/CLR 容器的 generic_container typedef 循环访问容器和显示其内容。

代码

// CppConsoleApp.cpp
// compile with: /clr /FUStlClrClassLibrary.dll

#include <cliext/deque>
#include <cliext/list>
#include <cliext/map>
#include <cliext/set>
#include <cliext/vector>

using namespace System;
using namespace StlClrClassLibrary;
using namespace cliext;

int main(array<System::String ^> ^args)
{
    StlClrClass theClass;

    Console::WriteLine("cliext::deque contents:");
    deque<wchar_t>::generic_container ^aDeque = theClass.GetDequeCpp();
    for each (wchar_t wc in aDeque)
    {
        Console::WriteLine(wc);
    }
    Console::WriteLine();

    Console::WriteLine("cliext::list contents:");
    list<float>::generic_container ^aList = theClass.GetListCpp();
    for each (float f in aList)
    {
        Console::WriteLine(f);
    }
    Console::WriteLine();

    Console::WriteLine("cliext::map contents:");
    map<int, String ^>::generic_container ^aMap = theClass.GetMapCpp();
    for each (map<int, String ^>::value_type rp in aMap)
    {
        Console::WriteLine("{0} {1}", rp->first, rp->second);
    }
    Console::WriteLine();

    Console::WriteLine("cliext::set contents:");
    set<double>::generic_container ^aSet = theClass.GetSetCpp();
    for each (double d in aSet)
    {
        Console::WriteLine(d);
    }
    Console::WriteLine();

    Console::WriteLine("cliext::vector contents:");
    vector<int>::generic_container ^aVector = theClass.GetVectorCpp();
    for each (int i in aVector)
    {
        Console::WriteLine(i);
    }
    Console::WriteLine();

    return 0;
}

Output

cliext::deque contents:
a
b

cliext::list contents:
3.14159
2.71828

cliext::map contents:
0 Hello
1 World

cliext::set contents:
2.71828
3.14159

cliext::vector contents:
10
20

示例 4

说明

在此示例中，我们创建使用示例创建类库、 1 和 2. c# 的客户端。此客户端使用 STL/CLR 容器的 ICollection<T> 方法循环访问容器和显示其内容。

代码

// CsConsoleApp.cs
// compile with: /r:Microsoft.VisualC.STLCLR.dll /r:StlClrClassLibrary.dll /r:System.dll

using System;
using System.Collections.Generic;
using StlClrClassLibrary;
using cliext;

namespace CsConsoleApp
{
    class Program
    {
        static int Main(string[] args)
        {
            StlClrClass theClass = new StlClrClass();

            Console.WriteLine("cliext::deque contents:");
            ICollection<char> iCollChar = theClass.GetDequeCs();
            foreach (char c in iCollChar)
            {
                Console.WriteLine(c);
            }
            Console.WriteLine();

            Console.WriteLine("cliext::list contents:");
            ICollection<float> iCollFloat = theClass.GetListCs();
            foreach (float f in iCollFloat)
            {
                Console.WriteLine(f);
            }
            Console.WriteLine();

            Console.WriteLine("cliext::map contents:");
            IDictionary<int, string> iDict = theClass.GetMapCs();
            foreach (KeyValuePair<int, string> kvp in iDict)
            {
                Console.WriteLine("{0} {1}", kvp.Key, kvp.Value);
            }
            Console.WriteLine();

            Console.WriteLine("cliext::set contents:");
            ICollection<double> iCollDouble = theClass.GetSetCs();
            foreach (double d in iCollDouble)
            {
                Console.WriteLine(d);
            }
            Console.WriteLine();

            Console.WriteLine("cliext::vector contents:");
            ICollection<int> iCollInt = theClass.GetVectorCs();
            foreach (int i in iCollInt)
            {
                Console.WriteLine(i);
            }
            Console.WriteLine();

            return 0;
        }
    }
}

Output

cliext::deque contents:
a
b

cliext::list contents:
3.14159
2.71828

cliext::map contents:
0 Hello
1 World

cliext::set contents:
2.71828
3.14159

cliext::vector contents:
10
20

请参见

其他资源

STL/CLR库参考

通过

如何:显示来自程序集的一个STL/CLR容器

示例 1

说明

代码

示例 2

说明

代码

示例 3

说明

代码

Output

示例 4

说明

代码

Output

请参见

其他资源

其他资源