Практическое руководство. Маршалирование строк ANSI для ADO.NET (C++/CLI)
Описание способа добавления собственной строки (char *) в базу данных, а также способа маршалирования System.String из базы данных в собственную строку.
Пример
В данном примере класс DatabaseClass создается для взаимодействия с объектом DataTable ADO.NET.Обратите внимание, что этот класс должен представлять собой исходный класс C++ class (по сравнению с ref class или value class).Это необходимо, поскольку данный класс будет использоваться в машинном коде, в котором применение управляемых типов недопустимо.Данный класс будет компилироваться для среды CLR в соответствии с директивой #pragma managed, предшествующей объявлению класса.Дополнительные сведения об этой директиве см. в разделе managed, unmanaged.
Обратите внимание на закрытый член класса DatabaseClass: gcroot<DataTable ^> table.Поскольку собственные типы не могут содержать управляемые типы, необходимо использовать ключевое слово gcroot.Дополнительные сведения о gcroot см. в разделе Практическое руководство. Объявление дескрипторов в собственных типах.
Остальная часть кода в данном примере представляет собой машинный код C++ в соответствии с директивой #pragma unmanaged, предшествующей main.В данном примере создается новый экземпляр класса DatabaseClass, а также вызываются его методы для создания таблицы и добавления в нее нескольких строк.Обратите внимание, что собственные строки C++ передаются как значения для столбца базы данных StringCol.Внутри класса DatabaseClass эти строки маршалируются в управляемые строки с помощью механизма маршалинга пространства имен System.Runtime.InteropServices.В частности, используется метод PtrToStringAnsi для маршалирования char * в String и метод StringToHGlobalAnsi — для маршалирования String в char *.
Примечание |
---|
Память, выделенная методу StringToHGlobalAnsi, должна быть освобождена с помощью вызова FreeHGlobal или 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;
}
Компиляция кода
Для того чтобы скомпилировать код из командной строки, сохраните пример кода в файл под названием adonet_marshal_string_native.cpp и введите нижеуказанный оператор:
cl /clr /FU System.dll /FU System.Data.dll /FU System.Xml.dll adonet_marshal_string_native.cpp
Безопасность
Дополнительные сведения о вопросах безопасности, связанные с ADO.NET, см. в разделе Securing ADO.NET Applications.
См. также
Ссылки
System.Runtime.InteropServices