如何：为 ADO.NET 封送 Unicode 字符串 (C++/CLI)
说明如何将本机 Unicode 字符串 (wchar_t *) 添加到数据库，以及如何将 System.String 从数据库封送到本机 Unicode 字符串。
示例
在此示例中，创建了 DatabaseClass 类以和 ADO.NET DataTable 对象进行交互。 请注意，此类是本机 C++ class（与 ref class 或 value class 相比较）。 这是必要的，因为我们要从本机代码使用此类，而在本机代码中无法使用托管类型。 此类将被编译为以 CLR 为目标，如类声明前面的 #pragma managed 指令所指示的一样。 有关此指令的更多信息，请参见 managed, unmanaged。
请注意 DatabaseClass 类的私有成员：gcroot<DataTable ^> table。 由于本机类型无法包含托管类型，gcroot 关键字是必要的。 有关 gcroot 的更多信息，请参见 如何：使用本机类型声明句柄。
此示例中的其余代码是本机 C++ 代码，如 main 前面的 #pragma unmanaged 指令所指示的一样。 在此示例中，我们将要创建 DatabaseClass 的一个新实例并调用其方法，以创建一个表并在表中填充一些行。 请注意，正在将 Unicode C++ 字符串作为数据库列 StringCol 的值进行传递。 在 DatabaseClass 内，已使用 System.Runtime.InteropServices 命名空间的封送功能将这些字符串封送到了托管字符串。 具体地说，方法 PtrToStringUni 用于将 wchar_t * 封送到 String，而方法 StringToHGlobalUni 用于将 String 封送到 wchar_t *。
备注
由 StringToHGlobalUni 分配的内存必须通过调用 FreeHGlobal 或 GlobalFree 释放。
// adonet_marshal_string_wide.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(wchar_t *stringColValue)
{
// Add a row to the table.
DataRow ^row = table->NewRow();
row["StringCol"] = Marshal::PtrToStringUni(
(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(wchar_t *dataColumn, wchar_t **values,
int valuesLength)
{
// Marshal the name of the column to a managed
// String.
String ^columnStr = Marshal::PtrToStringUni(
(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 wchar_t *.
values[i] = (wchar_t *)Marshal::StringToHGlobalUni(
(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(L"This is string 1.");
db->AddRow(L"This is string 2.");
// Now retrieve the rows and display their contents.
wchar_t *values[MAXCOLS];
int len = db->GetValuesForColumn(
L"StringCol", values, MAXCOLS);
for (int i = 0; i < len; i++)
{
wcout << "StringCol: " << values[i] << endl;
// Deallocate the memory allocated using
// Marshal::StringToHGlobalUni.
GlobalFree(values[i]);
}
delete db;
return 0;
}
编译代码
若要从命令行编译代码，请将代码示例保存在名为 adonet_marshal_string_wide.cpp 的文件中，并输入以下语句：
cl /clr /FU System.dll /FU System.Data.dll /FU System.Xml.dll adonet_marshal_string_wide.cpp
安全性
有关涉及 ADO.NET 安全问题的信息，请参见 Securing ADO.NET Applications。
请参见
参考
System.Runtime.InteropServices