immediatebind-Attribut

Das [immediatebind] -Attribut gibt an, dass die Datenbank sofort über alle Änderungen an einer Eigenschaft eines datengebundenen Objekts benachrichtigt wird.

[
    interface-attribute-list
] 
interface | dispinterface interface-name 
{
    [bindable, immediatebind[, optional-attribute-list]] returntype function-name(params)
}

Parameter

interface-attribute-list

Gibt eine Liste mit einem oder mehreren Attributen an, die für die Schnittstelle als Ganzes gelten.

Schnittstellenname

Gibt den Namen der Schnittstelle oder der Dispinterface an.

optional-attribute-list

Null oder mehr Funktionsattribute.

returntype

Gibt den Rückgabetyp der Funktion an.

Funktionsname

Gibt den Namen der Funktion in der IDL-Datei an.

params

Null oder mehr Funktionsparameter.

Bemerkungen

Mit dem [immediatebind]- Attribut können Steuerelemente zwischen Eigenschaften unterscheiden, die die Datenbank über jede Änderung benachrichtigen müssen, und solchen, die dies nicht tun. Beispielsweise sollte jede Änderung an einem Kontrollkästchen-Steuerelement sofort an die zugrunde liegende Datenbank gesendet werden, auch wenn das Steuerelement den Fokus nicht verloren hat. Bei einem Listbox-Steuerelement tritt jedoch eine Änderung auf, wenn eine andere Auswahl hervorgehoben wird. Die Datenbank über eine Änderung zu benachrichtigen, bevor das Steuerelement den Fokus verliert, wäre ineffizient und unnötig. Mit dem [immediatebind]- Attribut können Sie durch Festlegen des ImmediateBind-Bits einzelne Eigenschaften für ein Formular angeben, deren Änderungen sofort gemeldet werden sollen.

Eigenschaften, die über das [immediatebind]- Attribut verfügen, müssen ebenfalls über das Attribut [bindable] verfügen .

Flags

FUNCFLAG_FIMMEDIATEBIND, VARFLAG_FIMMEDIATEBIND

Beispiele

[
    uuid(12345678-1234-1234-1234-123456789ABC)
] 
interface MyObject : IUnknown
{
    properties:
    methods:
        [id(1), propget, bindable, immediatebind] long Size(void);

        [id(1), propput, bindable, 
         immediatebind] HRESULT Size([in]long lSize);
}

Weitere Informationen

bindable

TYPEFLAGS

Schnittstelle

Dispatchschnittstelle

ODL-Dateisyntax

ODL-Dateibeispiel

Generieren einer Typbibliothek mit MIDL