Como: empacotamento seqüências de caracteres ANSI para ADO.NET (C + + / CLI)

Artigo
02/25/2013

Demonstra como adicionar uma cadeia de caracteres nativa (char *) para um banco de dados e como empacotar um System.String de um banco de dados para uma cadeia de caracteres nativo.

Exemplo

Neste exemplo, a classe DatabaseClass é criado para interagir com um objeto ADO.NET DataTable objeto.Observe que essa classe é um C++ nativo class (em comparação com um ref class ou value class).Isso é necessário porque queremos usar essa classe de código nativo e não é possível usar tipos gerenciados no código nativo.Essa classe será ser compilada para direcionar o CLR, conforme indicado pelo #pragma managed diretiva anterior a declaração de classe.Para obter mais informações sobre essa diretiva, consulte gerenciado, não gerenciado.

Observe o membro particular da classe DatabaseClass: gcroot<DataTable ^> table.Como tipos nativos não podem conter tipos gerenciados, o gcroot palavra-chave é necessária.Para obter mais informações sobre gcroot, consulte: Como: Declare identificadores em tipos nativos.

O restante do código neste exemplo é o código C++ nativo, como indicado pelo #pragma unmanaged diretiva anterior main.Neste exemplo, estamos criando uma nova instância de DatabaseClass e chamando seus métodos para criar uma tabela e preencher algumas linhas na tabela.Observe que as seqüências de caracteres de C++ nativas estão sendo passadas como valores para a coluna de banco de dados StringCol.Dentro de DatabaseClass, essas cadeias de caracteres são empacotadas para gerenciado seqüências de caracteres usando a funcionalidade de empacotamento encontrada na System.Runtime.InteropServices namespace.Especificamente, o método PtrToStringAnsi é usado para empacotar uma char * para um Stringe o método StringToHGlobalAnsi é usado para empacotar uma String para um char *.

Observação
A memória alocada por StringToHGlobalAnsi deve ser desalocada chamando ou FreeHGlobal ou GlobalFree.

// adonet_marshal_string_native.cpp
// compile with: /clr /FU System.dll /FU System.Data.dll /FU System.Xml.dll
#include <comdef.h>
#include <gcroot.h>
#include <iostream>
using namespace std;

#using <System.Data.dll>
using namespace System;
using namespace System::Data;
using namespace System::Runtime::InteropServices;

#define MAXCOLS 100

#pragma managed
class DatabaseClass
{
public:
    DatabaseClass() : table(nullptr) { }

    void AddRow(char *stringColValue)
    {
        // Add a row to the table.
        DataRow ^row = table->NewRow();
        row["StringCol"] = Marshal::PtrToStringAnsi(
            (IntPtr)stringColValue);
        table->Rows->Add(row);
    }

    void CreateAndPopulateTable()
    {
        // Create a simple DataTable.
        table = gcnew DataTable("SampleTable");

        // Add a column of type String to the table.
        DataColumn ^column1 = gcnew DataColumn("StringCol",
            Type::GetType("System.String"));
        table->Columns->Add(column1);
    }

    int GetValuesForColumn(char *dataColumn, char **values,
        int valuesLength)
    {
        // Marshal the name of the column to a managed
        // String.
        String ^columnStr = Marshal::PtrToStringAnsi(
                (IntPtr)dataColumn);

        // Get all rows in the table.
        array<DataRow ^> ^rows = table->Select();
        int len = rows->Length;
        len = (len > valuesLength) ? valuesLength : len;
        for (int i = 0; i < len; i++)
        {
            // Marshal each column value from a managed string
            // to a char *.
            values[i] = (char *)Marshal::StringToHGlobalAnsi(
                (String ^)rows[i][columnStr]).ToPointer();
        }

        return len;
    }

private:
    // Using gcroot, you can use a managed type in
    // a native class.
    gcroot<DataTable ^> table;
};

#pragma unmanaged
int main()
{
    // Create a table and add a few rows to it.
    DatabaseClass *db = new DatabaseClass();
    db->CreateAndPopulateTable();
    db->AddRow("This is string 1.");
    db->AddRow("This is string 2.");

    // Now retrieve the rows and display their contents.
    char *values[MAXCOLS];
    int len = db->GetValuesForColumn(
        "StringCol", values, MAXCOLS);
    for (int i = 0; i < len; i++)
    {
        cout << "StringCol: " << values[i] << endl;

        // Deallocate the memory allocated using
        // Marshal::StringToHGlobalAnsi.
        GlobalFree(values[i]);
    }

    delete db;

    return 0;
}

Compilando o código

Para compilar o código na linha de comando, salve o exemplo de código em um arquivo chamado adonet_marshal_string_native.cpp e digite a instrução a seguir:
```
cl /clr /FU System.dll /FU System.Data.dll /FU System.Xml.dll adonet_marshal_string_native.cpp
```