Freigeben über


CStringData Class

Diese Klasse stellt die Daten eines Zeichenfolgenobjekts dar.

struct CStringData

Mitglieder

Methoden

AddRef

Inkrementiert den Verweiszähler des Zeichenfolgendatenobjekts.

data

Ruft die Textdaten eines Zeichenfolgenobjekts ab.

IsLocked

Bestimmt, ob der Puffer des zugeordneten Zeichenfolgenobjekts gesperrt ist.

IsShared

Bestimmt, ob der Puffer des zugeordneten Zeichenfolgenobjekts nur freigegeben wird.

Sperren

Sperrt den Puffer des zugeordneten Zeichenfolgenobjekts.

Release

Gibt das angegebene Zeichenfolgenobjekt frei.

Entsperren Sie

Setzt den Puffer des zugeordneten Zeichenfolgenobjekts frei.

Datenmember

nAllocLength

Länge zugeordnete Daten in XCHAR s nicht (einschließlich endgültige NULL-Zeichen)

nDataLength

Länge derzeit verwendete Daten in XCHAR s nicht (einschließlich endgültige NULL-Zeichen)

nRefs

Der aktuelle Verweiszählerwert des Objekts.

pStringMgr

Ein Zeiger auf Zeichenfolgenmanager dieses Zeichenfolgenobjekts.

Hinweise

Diese Klasse sollte von Entwicklern nur verwendet werden, die benutzerdefinierte Zeichenfolgenmanager implementieren. Weitere Informationen zu benutzerdefinierten Zeichenfolgenmanager, finden Sie unter Speicherverwaltung und CStringT

Diese Klasse kapselt verschiedene Typen von Informationen und Daten, die mit einem höheren Zeichenfolgenobjekt, wie CStringT, CSimpleStringT oder CFixedStringT-Objekten zugeordnet sind. Jedes höhere Zeichenfolgenobjekt enthält einen Zeiger auf dem zugeordneten CStringData-Objekt und ermöglicht mehrere Zeichenfolgenobjekte zum Punkt zum gleichen Zeichenfolgendatenobjekt. Diese Beziehung wird in den Verweiszähler (nRefs) des CStringData-Objekts dargestellt.

Hinweis

In bestimmten Fällen gibt ein Zeichenfolgentyp (z CFixedString) kein Zeichenfolgendatenobjekt mit mehr als einem höheren Zeichenfolgenobjekt frei.Weitere Informationen über dieses, finden Sie unter Speicherverwaltung und CStringT.

Diese Daten werden von zusammengesetzt:

  • Der Speicher-Manager (des Typs) IAtlStringMgr der Zeichenfolge.

  • Die aktuelle Länge (nDataLength) der Zeichenfolge.

  • Die zugeordnete Länge (nAllocLength) der Zeichenfolge. Aus Leistungsgründen kann sich jedoch von der aktuellen Zeichenfolgenlänge unterscheiden

  • Der aktuelle Verweiszähler (nRefs) CStringData des Objekts. Dieser Wert wird verwendet, wenn Sie bestimmt, wie viele Zeichenfolgenobjekte dasselbe Objekt CStringData freigeben.

  • Der tatsächliche Zeichenpuffer (Daten) der Zeichenfolge.

    Hinweis

    Der tatsächliche Zeichenpuffer des String-Objekts wird vom Zeichenfolgenmanager zugeordnet und wird in CStringData-Objekt angefügt.

Anforderungen

Header: atlsimpstr.h

Siehe auch

Referenz

Hierarchiediagramm

Weitere Ressourcen

ATL/MFC Shared Classes