ADO.NET İçin BSTR Dizeleri Nasıl Hazırlanır

Makale
08/01/2011

COM dizgisinin (BSTR) veritabanına nasıl ekleneceğini ve veritabanındaki bir System.String'in BSTR'a göre nasıl hazırlanacağını gösterir.

Örnek

Bu örnekte, ADO.NET DataTable nesnesiyle etkileşimde bulunabilmek için DatabaseClass sınıfı oluşturuldu. Bu sınıfın yerel C++ class'ı (ref class'a veya value class'a kıyasla) olduğunu unutmayın. Bu sınıfı yerel koddan kullanmak istediğimizden ve yerel kodda yönetilen türleri kullanamayacağınızdan dolayı bu gereklidir. Sınıf bildiriminden önceki #pragma managed yönergesinde de belirtildiği gibi bu sınıf hedef CLR için derlenecektir. Bu yönergeyle ilgili daha fazla bilgi için bkz. managed, unmanaged.

DatabaseClass sınıfının özel üyesine dikkat edin: gcroot<DataTable ^> table. Yerel türler yönetilen türleri içeremediğinden gcroot anahtar sözcüğü gereklidir. gcroot hakkında daha fazla bilgi için, bkz. Yerel Türlerde İşleyiciler Nasıl Bildirilir.

main'den önce gelen #pragma unmanaged yönergesinde de belirtildiği gibi bu örnekteki kodun kalan kısmı yerel C++ kodudur. Bu örnekte, DatabaseClass'ının yeni olgusunu oluşturacağız ve tablo oluşturup tablonun bazı satırlarını doldurmak için DatabaseClass'ın yöntemlerini çağıracağız. COM dizgilerinin, veritabanı sütunu StringCol için değer olarak geçtiğini unutmayın. DatabaseClass'ında bu dizeler System.Runtime.InteropServices isim uzayındaki hazırlama işlevi kullanılarak yönetilen dizeler için hazırlanırlar. Özellikle, PtrToStringBSTR yöntemi BSTR'yi String'e hazırlamak için ve StringToBSTR yöntemi String'i BSTR'ye hazırlamak için kullanılır.

Not

StringToBSTR tarafından ayrılan bellek, ya FreeBSTR'ın veya SysFreeString'nin çağrılmasıyla kaldırılmalıdır.

// adonet_marshal_string_bstr.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(BSTR stringColValue)
    {
        // Add a row to the table.
        DataRow ^row = table->NewRow();
        row["StringCol"] = Marshal::PtrToStringBSTR(
            (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(BSTR dataColumn, BSTR *values,
        int valuesLength)
    {
        // Marshal the name of the column to a managed
        // String.
        String ^columnStr = Marshal::PtrToStringBSTR(
                (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 BSTR.
            values[i] = (BSTR)Marshal::StringToBSTR(
                (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();

    BSTR str1 = SysAllocString(L"This is string 1.");
    db->AddRow(str1);

    BSTR str2 = SysAllocString(L"This is string 2.");
    db->AddRow(str2);

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

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

    SysFreeString(str1);
    SysFreeString(str2);
    SysFreeString(str3);
    delete db;

    return 0;
}

Kodu Derleme

Kodu komut satırından derlemek için, adonet_marshal_string_native.cpp adlı bir dosyaya kaydedin ve aşağıdaki deyimi girin:
```
cl /clr /FU System.dll /FU System.Data.dll /FU System.Xml.dll adonet_marshal_string_native.cpp
```